Reference NutrientViewer ActionsURIAction

Class URIAction

PDF action resolve a uniform resource identifier (web link).

It is an Immutable.Record and thus can be updated using set(key, value), for example: action.set("uri", "https://www.nutrient.io");.

A URI action contains an URI. When executing this annotation, we use window.open to create a new browser tab. We also clear the opener as a security measurement to avoid the target page to have access to your PDF state.

const newWindow = window.open(action.uri, "_blank");
newWindow.opener = null;

Learn more about the security problems when using _blank in this article from JitBit.

Please refer to the individual browser documentations for a lists of supported URI protocols. The most used protocols (http, https and mailto) are supported in all supported browsers.

Class

Example

Create a new URIAction

const action = new NutrientViewer.Actions.URIAction({ uri: "https://www.nutrient.io" });

Hierarchy

URIActionDataActionURIAction

Constructors

new URIAction(args)

Parameters
args
{ … }{
    uri?: string;
    subActions?:
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
        | null;
}
Optional
Inherited from URIActionData.constructor

Properties

subActions

Optional

NutrientViewer.Immutable.List<NutrientViewer.Actions.Action> | null

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

uri

string

The uniform resource identifier (web link) that should be resolved when triggering this action.

Immutable Record API

asImmutable

Deprecated

asImmutable(): this
Deprecated
Returns
this
Deprecated
Not part of the collection API the Nutrient Web SDK supports. Build the value once, or use withMutations().
See Also
Map#asImmutable
Inherited from Action.asImmutable

asMutable

Deprecated

asMutable(): this
Deprecated
Returns
this
Deprecated
Not part of the collection API the Nutrient Web SDK supports. Use withMutations().
See Also
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
Kextends "subActions"
Parameters
keyK
Returns
this
Inherited from Action.delete

deleteIn

deleteIn(keyPath: Iterable<unknown>): this
Returns a new instance of this Record type with the value at the given key path removed.

Also available as removeIn.

Parameters
keyPathIterable<unknown>
Returns
this
Inherited from Action.deleteIn

equals

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

get

get<K extends "subActions">(key: K): { … }[K]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
Kextends "subActions"
Parameters
keyK
Returns
{ … }[K]{
    subActions?:
        | NutrientViewer.Immutable.List<NutrientViewer.Actions.Action>
        | null;
}[K]
Inherited from Action.get

getIn

getIn(keyPath: Iterable<unknown>, notSetValue?: unknown): unknown
Parameters
keyPathIterable<unknown>
notSetValueunknown
Optional
Returns
unknown
Inherited from Action.getIn

has

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

merge

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

mergeDeep

mergeDeep(
    ...collections: (Iterable<[string, unknown], any, any> | Partial<{ … }>)[],
): thismergeDeep(
    ...collections: (
        | Iterable<[string, unknown], any, any>
        | Partial<
            {
                subActions?: | NutrientViewer.Immutable.List<
                    NutrientViewer.Actions.Action,
                >
                | null;
            },
        >
    )[],
): this
Parameters
...collections
(Iterable<[string, unknown], any, any> | Partial<{ … }>)[](
    | 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<{ … }>)[],
): thismergeDeepIn(
    keyPath: Iterable<unknown>,
    ...collections: (
        | Iterable<[string, unknown], any, any>
        | Partial<
            {
                subActions?: | NutrientViewer.Immutable.List<
                    NutrientViewer.Actions.Action,
                >
                | null;
            },
        >
    )[],
): this
Parameters
keyPathIterable<unknown>
...collections
(Iterable<[string, unknown], any, any> | Partial<{ … }>)[](
    | 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<{ … }>)[],
): thismergeDeepWith(
    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<{ … }>)[](
    | Iterable<[string, unknown], any, any>
    | Partial<
        {
            subActions?: | NutrientViewer.Immutable.List<
                NutrientViewer.Actions.Action,
            >
            | null;
        },
    >
)[]
Returns
this
Inherited from Action.mergeDeepWith

mergeIn

Deprecated

mergeIn(
    keyPath: Iterable<unknown>,
    ...collections: (Iterable<[string, unknown], any, any> | Partial<{ … }>)[],
): thismergeIn(
    keyPath: Iterable<unknown>,
    ...collections: (
        | Iterable<[string, unknown], any, any>
        | Partial<
            {
                subActions?: | NutrientViewer.Immutable.List<
                    NutrientViewer.Actions.Action,
                >
                | null;
            },
        >
    )[],
): this
Deprecated
Parameters
keyPathIterable<unknown>
...collections
(Iterable<[string, unknown], any, any> | Partial<{ … }>)[](
    | Iterable<[string, unknown], any, any>
    | Partial<
        {
            subActions?: | NutrientViewer.Immutable.List<
                NutrientViewer.Actions.Action,
            >
            | null;
        },
    >
)[]
Returns
this
Deprecated
Not part of the collection API the Nutrient Web SDK supports. Use update() followed by merge().

Inherited from Action.mergeIn

mergeWith

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

removeIn

Deprecated

removeIn(keyPath: Iterable<unknown>): this
Deprecated
Parameters
keyPathIterable<unknown>
Returns
this
Deprecated
Not part of the collection API the Nutrient Web SDK supports. Use deleteIn(), or update() followed by delete().

Inherited from Action.removeIn

set

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

setIn

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

toJS

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(): { … }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

Deprecated

toSeq(): Keyed<string, unknown>
Deprecated
Returns
Keyed<string, unknown>
Deprecated
Not part of the collection API the Nutrient Web SDK supports. Use entries().

Inherited from Action.toSeq

update

update<K extends "subActions">(
    key: K,
    updater: (value: { … }[K]) => { … }[K],
): thisupdate<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
Kextends "subActions"
Parameters
keyK
updater
(value: { … }[K]) => { … }[K](
    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
keyPathIterable<unknown>
notSetValueunknown
updater(value: unknown) => unknown
Returns
this
Inherited from Action.updateIn
updateIn(keyPath: Iterable<unknown>, updater: (value: unknown) => unknown): this
Parameters
keyPathIterable<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 Also
Map#withMutations
Inherited from Action.withMutations

Class URIAction

Example

Hierarchy

Constructors

Parameters

Properties

Immutable Record API

Returns

Deprecated

See Also

Returns

Deprecated

See Also

Returns

Type Parameters

Parameters

Returns

Parameters

Returns

Parameters

Returns

Type Parameters

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

Deprecated

Parameters

Returns

Parameters

Returns

Deprecated

Type Parameters

Parameters

Returns

Parameters

Returns

Returns

Returns

Returns

Deprecated

Type Parameters

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

See Also