Method setValue

src/document/forms/fields/text-field.ts:98–110

* Set the text value. * * This method is async because it regenerates the field's appearance * stream after setting the value. * * @param value The new text value * @throws {Error} if field is read-only

(value: string)

   * @throws {Error} if field is read-only
   */
  setValue(value: string): void {
    this.assertWritable();

    // Truncate if maxLength is set
    const finalValue = this.maxLength > 0 ? value.slice(0, this.maxLength) : value;

    // Set /V on field dict
    this.dict.set("V", PdfString.fromString(finalValue));
    this.needsAppearanceUpdate = true;

    // Regenerate appearance immediately
    this.applyChange();
  }
}