> ## Documentation Index
> Fetch the complete documentation index at: https://codegeninc-tawsif-change-additional-tools-to-tools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# TSWhileStatement
> A TypeScript while statement class that represents while loops and manages their condition and code block. This class provides functionality for handling while statements in TypeScript code, including managing the loop's condition and associated code block. It extends the base WhileStatement class with TypeScript-specific behavior.
export const Attribute = ({type, description}) => ;
export const GithubLinkNote = ({link}) =>
;
export const HorizontalDivider = ({light = false}) => ;
export const Return = ({return_type, description}) => ;
export const ParameterWrapper = ({children}) => ;
export const Parameter = ({name, type, description, defaultValue}) =>
{defaultValue ?
default:
{defaultValue}
:
required
}
{description}
;
### Inherits from
[TSHasBlock](/api-reference/typescript/TSHasBlock), [WhileStatement](/api-reference/core/WhileStatement), [HasBlock](/api-reference/core/HasBlock), [Statement](/api-reference/core/Statement), [Expression](/api-reference/core/Expression), [Editable](/api-reference/core/Editable)
## Attributes
### code\_block
TSCodeBlock } description="The code block that represents the body of the while statement." />
### condition
Expression [ TSWhileStatement ] } description="The condition expression of the while statement." />
### decorators
list[ TSDecorator ] } description="Returns a list of decorators associated with this symbol." />
### docstring
TSCommentGroup | None } description="Retrieves the docstring of a function or class." />
### extended
SymbolGroup } description="Returns a SymbolGroup of all extended nodes associated with this element." />
### extended\_source
str } description="Returns the source text representation of all extended nodes." />
### file
TSFile } description="The file object that this Editable instance belongs to." />
### filepath
str } description="The file path of the file that this Editable instance belongs to." />
### function\_calls
list[ FunctionCall ] } description="Returns all function calls within the while statement block." />
### index
int } description="The 0-based index of the statement in the parent code block." />
### is\_decorated
bool } description="Checks if the current symbol has a decorator." />
### jsx\_elements
list[ JSXElement [ TSWhileStatement ]] } description="Returns a list of all JSX elements contained within this symbol." />
### nested\_code\_blocks
list[ TSCodeBlock ] } description="Returns all nested CodeBlocks within the statement." />
### nested\_statements
list[ MultiLineCollection [ Statement [ TSWhileStatement ], Editable ]] } description="Returns a list of statement collections within nested code blocks." />
### parent
Editable } description="The parent node of this Editable instance." />
### parent\_class
TSClass | None } description="Find the class this node is contained in" />
### parent\_function
TSFunction | None } description="Find the function this node is contained in" />
### parent\_statement
Statement | None } description="Find the statement this node is contained in" />
### resolved\_value
Expression | list[ Expression ] } description="Returns the resolved type of an Expression." />
### source
str } description="Text representation of the Editable instance." />
### variable\_usages
list[ Editable ] } description="Returns Editables for all TreeSitter node instances of variable usages within this node's" />
## Methods
### add\_decorator
Adds a decorator to a function or method.
str } description="The decorator to add, including the '@' symbol." defaultValue="" />
bool, optional } description="If True, skips adding if the decorator exists." defaultValue="False" />
bool } description="True if the decorator was added, False if skipped." />
### ancestors
Find all ancestors of the node of the given type. Does not return itself
list[ Editable ] } description="" />
### edit
Replace the source of this `Editable` with `new_src`.
str } description="The new source text to replace the current text with." defaultValue="" />
bool } description="If True, adjusts the indentation of `new_src` to match the current text's indentation level. Defaults to False." defaultValue="False" />
int } description="The priority of the edit transaction. Higher priority edits are applied first. Defaults to 0." defaultValue="0" />
bool } description="If True, deduplicates identical transactions. Defaults to True." defaultValue="True" />
None } description="" />
### find
Find and return matching nodes or substrings within an Editable instance.
Union[list[str], str] } description="One or more strings to search for." defaultValue="" />
bool } description="If True, only return nodes whose source exactly matches one of the strings_to_match." defaultValue="False" />
list[ Editable ] } description="A list of Editable instances that match the search criteria." />
### find\_string\_literals
Returns a list of string literals within this node's source that match any of the given
list[str] } description="A list of strings to search for in string literals." defaultValue="" />
bool } description="If True, matches substrings within string literals. If False, only matches exact strings. Defaults to False." defaultValue="False" />
list[ Editable [ TSWhileStatement ]] } description="A list of Editable objects representing the matching string literals." />
### flag
Adds a visual flag comment to the end of this Editable's source text.
CodeFlag[ TSWhileStatement ] } description="" />
### get\_component
Returns a specific JSX element from within this symbol's JSX elements.
str } description="The name of the JSX component to find." defaultValue="" />
JSXElement [ TSWhileStatement ] | None } description="The matching JSX element if found, None otherwise." />
### get\_variable\_usages
Returns Editables for all TreeSitter nodes corresponding to instances of variable usage
str } description="The variable name to search for." defaultValue="" />
bool } description="If True, matches variables where var_name is a substring. If False, requires exact match. Defaults to False." defaultValue="False" />
Sequence[ Editable [ TSWhileStatement ]] } description="List of Editable objects representing variable usage nodes matching the given name." />
### insert\_after
Inserts code after this node.
str } description="The source code to insert after this node." defaultValue="" />
bool, optional } description="Whether to adjust the indentation of new_src to match the current node. Defaults to False." defaultValue="False" />
bool, optional } description="Whether to add a newline before the new_src. Defaults to True." defaultValue="True" />
int, optional } description="Priority of the insertion transaction. Defaults to 0." defaultValue="0" />
bool, optional } description="Whether to deduplicate identical transactions. Defaults to True." defaultValue="True" />
None } description="" />
### insert\_before
Inserts text before this node's source with optional indentation and newline handling.
str } description="The text to insert before this node." defaultValue="" />
bool } description="Whether to fix the indentation of new_src to match the current node. Defaults to False." defaultValue="False" />
bool } description="Whether to add a newline after new_src. Defaults to True." defaultValue="True" />
int } description="Transaction priority for managing multiple edits. Defaults to 0." defaultValue="0" />
bool } description="Whether to deduplicate identical transactions. Defaults to True." defaultValue="True" />
None } description="" />
### is\_child\_of
Checks if this node is a descendant of the given editable instance in the AST.
bool } description="" />
### is\_wrapped\_in
Check if this node is contained another node of the given class
bool } description="" />
### parent\_of\_type
Find the first ancestor of the node of the given type. Does not return itself
Editable | None } description="" />
### parent\_of\_types
Find the first ancestor of the node of the given type. Does not return itself
Editable | None } description="" />
### reduce\_condition
Reduces an editable to the following condition
None } description="" />
### remove
Deletes this Node and its related extended nodes (e.g. decorators, comments).
bool } description="Whether to delete surrounding whitespace and formatting. Defaults to True." defaultValue="True" />
int } description="Priority of the removal transaction. Higher priority transactions are executed first. Defaults to 0." defaultValue="0" />
bool } description="Whether to deduplicate removal transactions at the same location. Defaults to True." defaultValue="True" />
None } description="" />
### replace
Search and replace occurrences of text within this node's source and its extended nodes.
str } description="The text or pattern to search for." defaultValue="" />
str } description="The text to replace matches with." defaultValue="" />
int, optional } description="Maximum number of replacements to make. Defaults to -1 (replace all)." defaultValue="-1" />
bool, optional } description="Whether to treat 'old' as a regex pattern. Defaults to False." defaultValue="False" />
int, optional } description="Priority of the replacement operation. Defaults to 0." defaultValue="0" />
int } description="The total number of replacements made." />
### search
Returns a list of all regex match of `regex_pattern`, similar to python's re.search().
str } description="The regular expression pattern to search for." defaultValue="" />
bool } description="When False, excludes the contents of string literals from the search. Defaults to True." defaultValue="True" />
bool } description="When False, excludes the contents of comments from the search. Defaults to True." defaultValue="True" />
list[ Editable ] } description="A list of Editable objects corresponding to the matches found." />
### set\_docstring
Sets or updates a docstring for a code element.
str } description="The docstring text to be added or updated." defaultValue="" />
bool, optional } description="Whether to automatically format the text into a docstring format. Defaults to True." defaultValue="True" />
bool, optional } description="Whether to clean existing formatting from the docstring before inserting. Defaults to True." defaultValue="True" />
bool, optional } description="Whether to add leading "*" to each line of the comment block. Defaults to True." defaultValue="True" />
bool, optional } description="Whether to force single line comments to be multi-line. Defaults to False." defaultValue="False" />
None } description="" />