Pomeranian development reference / lib-essential/src/text-input / TextInput / appendText
Method: appendText()
appendText(
text,options?):Promise<void>
Defined in: packages/lib-essential/src/editable-text.ts:24
Append to the current value through native fill, independently of caret/selection. Supports native text/search/email/password/tel/url inputs (including implicit or invalid types resolved as text) and textarea. Structured inputs, labels and contenteditable are rejected. Targets are checked at action time. Options, waiting, constraints and errors remain native fill behavior; this does not promise per-character keyboard events or rich-editor formatting preservation. Reading and filling are not atomic against application edits or DOM replacement.
Parameters
text
string
Text to append after the current value, ignoring caret and selection.
options?
Native fill options: force bypasses actionability checks, timeout applies independently to the preliminary read and native fill (not a shared total budget), signal cancels both stages, and deprecated noWaitAfter has no effect at the supported Playwright pin.
force?
boolean
Whether to bypass the actionability checks. Defaults to false.
noWaitAfter?
boolean
This option has no effect.
Deprecated
This option has no effect.
signal?
AbortSignal
Allows to cancel the operation using an AbortSignal. If the signal is aborted, the operation will be aborted and throw an error. Note that providing a signal does not disable the default timeout, which can be changed using browserContext.setDefaultTimeout(timeout) or page.setDefaultTimeout(timeout); pass timeout: 0 to disable the timeout entirely.
timeout?
number
Maximum time in milliseconds. Defaults to 0 - no timeout. The default value can be changed via actionTimeout option in the config, or by using the browserContext.setDefaultTimeout(timeout) or page.setDefaultTimeout(timeout) methods.
Returns
Promise<void>
Since
Available since @pomeranian/lib-essential@Unreleased
Inherited from
Element.with( EditableText, ).appendText
Context
Owner: TextInput.
Owner type parameters
Root
Root extends UnboundRoot = UnboundRoot
Unreleased @pomeranian/lib-essential API: @pomeranian/lib-essential implementation from main; no npm release is implied.