Class JavaScriptAction

PDF action to run arbitrary JavaScript.

It is an Immutable.Record and thus can be updated using set(key, value), for example: action.set("script", "alert(...)");.

Example

Create a new JavaScriptAction

const action = new NutrientViewer.Actions.JavaScriptAction({
  script: "alert(...)"
});

Example

Create a button to import a image using a JavaScriptAction

const widget = new NutrientViewer.Annotations.WidgetAnnotation({
  id: NutrientViewer.generateInstantId(),
  pageIndex: 0,
  formFieldName: "buttonIcon",
  boundingBox: new NutrientViewer.Geometry.Rect({
    left: 100,
    top: 200,
    width: 100,
    height: 100
  }),
  action: new NutrientViewer.Actions.JavaScriptAction({
    script: "event.target.buttonImportIcon()"
  }),
  borderWidth: 0
});
const formField = new NutrientViewer.FormFields.ButtonFormField({
  name: "buttonIcon",
  annotationIds: NutrientViewer.Immutable.List([widget.id])
});
await instance.create([widget, formField]);

Hierarchy

JavaScriptActionData
NutrientViewer.Actions.Action
- JavaScriptAction

Index

Constructors

constructor

new JavaScriptAction(
    args?: { script?: string } & {
        subActions?:
            | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
            | null;
    },
): NutrientViewer.Actions.JavaScriptAction
Parameters
- Optionalargs: { script?: string } & {
      subActions?:
          | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
          | null;
  }
  - Optionalscript?: string
    The JavaScript to run.
  - OptionalsubActions?: NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> | null
Returns NutrientViewer.Actions.JavaScriptAction
Inherited from JavaScriptActionData.constructor

Properties

script

script: string = ...

The JavaScript to run.

`Optional`subActions

subActions?: NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> | null

Actions can be chained by adding them to this immutable List.

Methods

asImmutable

asImmutable(): this
Returns this
See
Map#asImmutable

Inherited from Action.asImmutable

asMutable

asMutable(): this
Returns this
See
Map#asMutable

Inherited from Action.asMutable

clear

clear(): this
Returns a new instance of this Record type with all values set to their default values.

Returns this
Inherited from Action.clear

delete

delete<K extends "subActions">(key: K): this
Returns a new instance of this Record type with the value for the specific key set to its default value.
Type Parameters
- K extends "subActions"
Parameters
- key: K
Returns this
Alias
remove

Inherited from Action.delete

deleteIn

deleteIn(keyPath: Iterable<unknown>): this
Parameters
- keyPath: Iterable<unknown>
Returns this
Alias
removeIn

Inherited from Action.deleteIn

equals

equals(other: unknown): boolean
Parameters
- other: unknown
Returns boolean
Inherited from Action.equals

get

get<K extends "subActions">(
    key: K,
): {
    subActions?:
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
        | null;
}[K]
Returns the value associated with the provided key, which may be the default value defined when creating the Record factory function.

If the requested key is not defined by this Record type, then notSetValue will be returned if provided. Note that this scenario would produce an error when using Flow or TypeScript.
Type Parameters
- K extends "subActions"
Parameters
- key: K
Returns {
    subActions?:
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
        | null;
}[K]
Inherited from Action.get

getIn

getIn(keyPath: Iterable<unknown>, notSetValue?: unknown): unknown
Parameters
- keyPath: Iterable<unknown>
- OptionalnotSetValue: unknown
Returns unknown
Inherited from Action.getIn

has

has(key: unknown): boolean
Parameters
- key: unknown
Returns boolean
Inherited from Action.has

merge

merge(
    ...collections: Partial<
        {
            subActions?: | NutrientViewer.Immutable.List<
                NutrientViewer.Actions.Action,
            >
            | null;
        },
    >[],
): this
Parameters
- ...collections: Partial<
      {
          subActions?: | NutrientViewer.Immutable.List<
              NutrientViewer.Actions.Action,
          >
          | null;
      },
  >[]
Returns this
Inherited from Action.merge

mergeDeep

mergeDeep(
    ...collections: (
        | Iterable<[string, unknown], any, any>
        | Partial<
            {
                subActions?: | NutrientViewer.Immutable.List<
                    NutrientViewer.Actions.Action,
                >
                | null;
            },
        >
    )[],
): this
Parameters
- ...collections: (
      | Iterable<[string, unknown], any, any>
      | Partial<
          {
              subActions?: | NutrientViewer.Immutable.List<
                  NutrientViewer.Actions.Action,
              >
              | null;
          },
      >
  )[]
Returns this
Inherited from Action.mergeDeep

mergeDeepIn

mergeDeepIn(
    keyPath: Iterable<unknown>,
    ...collections: (
        | Iterable<[string, unknown], any, any>
        | Partial<
            {
                subActions?: | NutrientViewer.Immutable.List<
                    NutrientViewer.Actions.Action,
                >
                | null;
            },
        >
    )[],
): this
Parameters
- keyPath: Iterable<unknown>
- ...collections: (
      | Iterable<[string, unknown], any, any>
      | Partial<
          {
              subActions?: | NutrientViewer.Immutable.List<
                  NutrientViewer.Actions.Action,
              >
              | null;
          },
      >
  )[]
Returns this
Inherited from Action.mergeDeepIn

mergeDeepWith

mergeDeepWith(
    merger: (previous?: unknown, next?: unknown, key?: string) => unknown,
    ...collections: (
        | Iterable<[string, unknown], any, any>
        | Partial<
            {
                subActions?: | NutrientViewer.Immutable.List<
                    NutrientViewer.Actions.Action,
                >
                | null;
            },
        >
    )[],
): this
Parameters
- merger: (previous?: unknown, next?: unknown, key?: string) => unknown
- ...collections: (
      | Iterable<[string, unknown], any, any>
      | Partial<
          {
              subActions?: | NutrientViewer.Immutable.List<
                  NutrientViewer.Actions.Action,
              >
              | null;
          },
      >
  )[]
Returns this
Inherited from Action.mergeDeepWith

mergeIn

mergeIn(
    keyPath: Iterable<unknown>,
    ...collections: (
        | Iterable<[string, unknown], any, any>
        | Partial<
            {
                subActions?: | NutrientViewer.Immutable.List<
                    NutrientViewer.Actions.Action,
                >
                | null;
            },
        >
    )[],
): this
Parameters
- keyPath: Iterable<unknown>
- ...collections: (
      | Iterable<[string, unknown], any, any>
      | Partial<
          {
              subActions?: | NutrientViewer.Immutable.List<
                  NutrientViewer.Actions.Action,
              >
              | null;
          },
      >
  )[]
Returns this
Inherited from Action.mergeIn

mergeWith

mergeWith(
    merger: (previous?: unknown, next?: unknown, key?: string) => unknown,
    ...collections: (
        | Iterable<[string, unknown], any, any>
        | Partial<
            {
                subActions?: | NutrientViewer.Immutable.List<
                    NutrientViewer.Actions.Action,
                >
                | null;
            },
        >
    )[],
): this
Parameters
- merger: (previous?: unknown, next?: unknown, key?: string) => unknown
- ...collections: (
      | Iterable<[string, unknown], any, any>
      | Partial<
          {
              subActions?: | NutrientViewer.Immutable.List<
                  NutrientViewer.Actions.Action,
              >
              | null;
          },
      >
  )[]
Returns this
Inherited from Action.mergeWith

removeIn

removeIn(keyPath: Iterable<unknown>): this
Parameters
- keyPath: Iterable<unknown>
Returns this
Inherited from Action.removeIn

set

set<K extends "subActions">(
    key: K,
    value: {
        subActions?:
            | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
            | null;
    }[K],
): this
Type Parameters
- K extends "subActions"
Parameters
- key: K
- value: {
      subActions?:
          | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
          | null;
  }[K]
Returns this
Inherited from Action.set

setIn

setIn(keyPath: Iterable<unknown>, value: unknown): this
Parameters
- keyPath: Iterable<unknown>
- value: unknown
Returns this
Inherited from Action.setIn

toJS

toJS(): {
    subActions?: | NutrientViewer.Immutable.List<
        NutrientViewer.Actions.Action,
    >
    | null;
}
Deeply converts this Record to equivalent native JavaScript Object.

Note: This method may not be overridden. Objects with custom serialization to plain JS may override toJSON() instead.

Returns {
    subActions?:
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
        | null;
}
Inherited from Action.toJS

toJSON

toJSON(): {
    subActions?: | NutrientViewer.Immutable.List<
        NutrientViewer.Actions.Action,
    >
    | null;
}
Shallowly converts this Record to equivalent native JavaScript Object.

Returns {
    subActions?:
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
        | null;
}
Inherited from Action.toJSON

toSeq

toSeq(): Keyed<string, unknown>
Returns Keyed<string, unknown>
Inherited from Action.toSeq

update

update<K extends "subActions">(
    key: K,
    updater: (
        value: {
            subActions?:
                | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
                | null;
        }[K],
    ) => {
        subActions?: | NutrientViewer.Immutable.List<
            NutrientViewer.Actions.Action,
        >
        | null;
    }[K],
): this
Type Parameters
- K extends "subActions"
Parameters
- key: K
- updater: (
      value: {
          subActions?:
              | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
              | null;
      }[K],
  ) => {
      subActions?: | NutrientViewer.Immutable.List<
          NutrientViewer.Actions.Action,
      >
      | null;
  }[K]
Returns this
Inherited from Action.update

updateIn

updateIn(
    keyPath: Iterable<unknown>,
    notSetValue: unknown,
    updater: (value: unknown) => unknown,
): this
Parameters
- keyPath: Iterable<unknown>
- notSetValue: unknown
- updater: (value: unknown) => unknown
Returns this
Inherited from Action.updateIn
updateIn(keyPath: Iterable<unknown>, updater: (value: unknown) => unknown): this
Parameters
- keyPath: Iterable<unknown>
- updater: (value: unknown) => unknown
Returns this
Inherited from Action.updateIn

withMutations

withMutations(mutator: (mutable: this) => unknown): this
Note: Not all methods can be used on a mutable collection or within withMutations! Only set may be used mutatively.
Parameters
- mutator: (mutable: this) => unknown
Returns this
See
Map#withMutations

Inherited from Action.withMutations

Class JavaScriptAction

Example

Example

Hierarchy

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Optionalscript?: string

OptionalsubActions?: NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> | null

Returns NutrientViewer.Actions.JavaScriptAction

Properties

script

OptionalsubActions

Methods

asImmutable

Returns this

See

asMutable

Returns this

See

clear

Returns this

delete

Type Parameters

Parameters

Returns this

Alias

deleteIn

Parameters

Returns this

Alias

equals

Parameters

Returns boolean

get

Type Parameters

Parameters

Returns { subActions?: | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> | null;}[K]

getIn

Parameters

Returns unknown

has

Parameters

Returns boolean

merge

Parameters

Returns this

mergeDeep

Parameters

Returns this

mergeDeepIn

Parameters

Returns this

mergeDeepWith

Parameters

Returns this

mergeIn

Parameters

Returns this

mergeWith

Parameters

Returns this

removeIn

Parameters

Returns this

set

Type Parameters

Parameters

Returns this

setIn

Parameters

Returns this

toJS

Returns { subActions?: | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> | null;}

toJSON

Returns { subActions?: | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> | null;}

`Optional`script?: string

`Optional`subActions?: NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> | null

`Optional`subActions

Returns {
subActions?:
| NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
| null;
}[K]

Returns {
subActions?:
| NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
| null;
}

Returns {
subActions?:
| NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
| null;
}