Interface JQueryStatic

Index

Methods

Methods

public postMessage(message: string, targetUrl: string, target?: Window)

This method will call window.postMessage if available, setting the targetOrigin parameter to the base of the targetUrl parameter for maximum security in browsers that support it. If window.postMessage is not available, the target window’s location.hash will be used to pass the message. If an object is passed as the message param, it will be serialized into a string using the jQuery.param method.

Parameters

  • message: string

    A message to be passed to the other frame.

  • targetUrl: string

    The URL of the other frame this window is attempting to communicate with. This must be the exact URL (including any query string) of the other window for this script to work in browsers that don’t support window.postMessage.

  • target?: Window optional

    A reference to the other frame this window is attempting to communicate with. If omitted, defaults to parent.

public postMessage(message: { [key: string]: any; }, targetUrl: string, target?: Window)

This method will call window.postMessage if available, setting the targetOrigin parameter to the base of the targetUrl parameter for maximum security in browsers that support it. If window.postMessage is not available, the target window’s location.hash will be used to pass the message. If an object is passed as the message param, it will be serialized into a string using the jQuery.param method.

Parameters

  • message: { [key: string]: any; }

    An object to be serialized into a params string, using the jQuery.param method.

  • targetUrl: string

    The URL of the other frame this window is attempting to communicate with. This must be the exact URL (including any query string) of the other window for this script to work in browsers that don’t support window.postMessage.

  • target?: Window optional

    A reference to the other frame this window is attempting to communicate with. If omitted, defaults to parent.

public receiveMessage(callback: (event: MessageEvent) => any, sourceOrigin?: string, delay?: number)

Register a single callback for either a window.postMessage call, if supported, or if unsupported, for any change in the current window location.hash. If window.postMessage is supported and sourceOrigin is specified, the source window will be checked against this for maximum security. If window.postMessage is unsupported, a polling loop will be started to watch for changes to the location.hash.

Parameters

  • callback: (event: MessageEvent) => any

    This callback will execute whenever a jQuery.postMessage message is received, provided the sourceOrigin matches. If callback is omitted, any existing receiveMessage event bind or polling loop will be canceled.

  • sourceOrigin?: string optional

    If window.postMessage is available and this value is not equal to the event.origin property, the callback will not be called.

  • delay?: number optional

    An optional zero-or-greater delay in milliseconds at which the polling loop will execute (for browser that don’t support window.postMessage). If omitted, defaults to 100.

public receiveMessage(callback: (event: MessageEvent) => any, sourceOrigin?: (origin: string) => boolean, delay?: number)

Register a single callback for either a window.postMessage call, if supported, or if unsupported, for any change in the current window location.hash. If window.postMessage is supported and sourceOrigin is specified, the source window will be checked against this for maximum security. If window.postMessage is unsupported, a polling loop will be started to watch for changes to the location.hash.

Parameters

  • callback: (event: MessageEvent) => any

    This callback will execute whenever a jQuery.postMessage message is received, provided the sourceOrigin matches. If callback is omitted, any existing receiveMessage event bind or polling loop will be canceled.

  • sourceOrigin?: (origin: string) => boolean optional

    If window.postMessage is available and this function returns false when passed the event.origin property, the callback will not be called.

  • delay?: number optional

    An optional zero-or-greater delay in milliseconds at which the polling loop will execute (for browser that don’t support window.postMessage). If omitted, defaults to 100.