chrome.webviewTag

Properties

• since

  number optional

  Clear data accumulated on or after this date, represented in milliseconds since the epoch (accessible via the getTime method of the JavaScript Date object). If absent, defaults to 0 (which would remove all browsing data).

Properties

• appcache

  boolean optional

  Websites' appcaches.

• cache

  boolean optional

  Chrome 44+

  Since Chrome 43. The browser's cache. Note: when removing data, this clears the entire cache; it is not limited to the range you specify.

• cookies

  boolean optional

  The partition's cookies.

• fileSystems

  boolean optional

  Websites' filesystems.

• indexedDB

  boolean optional

  Websites' IndexedDB data.

• localStorage

  boolean optional

  Websites' local storage data.

• persistentCookies

  boolean optional

  Chrome 58+

  The partition's persistent cookies.

• sessionCookies

  boolean optional

  Chrome 58+

  The partition's session cookies.

• webSQL

  boolean optional

  Websites' WebSQL data.

Properties

• all_frames

  boolean optional

  If all_frames is true, this implies that the JavaScript or CSS should be injected into all frames of current page. By default, all_frames is false and the JavaScript or CSS is only injected into the top frame.

• css

  InjectionItems optional

  The CSS code or a list of CSS files to be injected into matching pages. These are injected in the order they appear, before any DOM is constructed or displayed for the page.

• exclude_globs

  string[] optional

  Applied after matches to exclude URLs that match this glob. Intended to emulate the @exclude Greasemonkey keyword.

• exclude_matches

  string[] optional

  Excludes pages that this content script would otherwise be injected into.

• include_globs

  string[] optional

  Applied after matches to include only those URLs that also match this glob. Intended to emulate the @include Greasemonkey keyword.

• js

  InjectionItems optional

  The JavaScript code or a list of JavaScript files to be injected into matching pages. These are injected in the order they appear.

• match_about_blank

  boolean optional

  Whether to insert the content script on about:blank and about:srcdoc. Content scripts will only be injected on pages when their inherit URL is matched by one of the declared patterns in the matches field. The inherit URL is the URL of the document that created the frame or window. Content scripts cannot be inserted in sandboxed frames.

• matches

  string[]

  Specifies which pages this content script will be injected into.

• name

  string

  The name of the content script to inject.

• run_at

  RunAt optional

  The soonest that the JavaScript or CSS will be injected into the tab. Defaults to "document_idle".

Properties

• postMessage

  void

  Posts a message to the embedded web content as long as the embedded content is displaying a page from the target origin. This method is available once the page has completed loading. Listen for the contentload event and then call the method.

  The guest will be able to send replies to the embedder by posting message to event.source on the message event it receives.

  This API is identical to the HTML5 postMessage API for communication between web pages. The embedder may listen for replies by adding a message event listener to its own frame.

  The postMessage function looks like: (message: any, targetOrigin: string) => {...}

  • message

    any

    Message object to send to the guest.

  • targetOrigin

    string

    Specifies what the origin of the guest window must be for the event to be dispatched.

Properties

• checked

  boolean optional

  The initial state of a checkbox or radio item: true for selected and false for unselected. Only one radio item can be selected at a time in a given group of radio items.

• contexts

  [ContextType, ...ContextType[]] optional

  List of contexts this menu item will appear in. Defaults to ['page'] if not specified.

• documentUrlPatterns

  string[] optional

  Lets you restrict the item to apply only to documents whose URL matches one of the given patterns. (This applies to frames as well.) For details on the format of a pattern, see Match Patterns.

• enabled

  boolean optional

  Whether this context menu item is enabled or disabled. Defaults to true.

• id

  string optional

  The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension.

• parentId

  string | number optional

  The ID of a parent menu item; this makes the item a child of a previously added item.

• targetUrlPatterns

  string[] optional

  Similar to documentUrlPatterns, but lets you filter based on the src attribute of img/audio/video tags and the href of anchor tags.

• title

  string optional

  The text to be displayed in the item; this is required unless type is 'separator'. When the context is 'selection', you can use %s within the string to show the selected text. For example, if this parameter's value is "Translate '%s' to Pig Latin" and the user selects the word "cool", the context menu item for the selection is "Translate 'cool' to Pig Latin".

• type

  ItemType optional

  The type of menu item. Defaults to 'normal' if not specified.

• onclick

  void optional

  A function that will be called back when the menu item is clicked.

  The onclick function looks like: (info: OnClickData) => {...}

  • info

    OnClickData

    Information about the item clicked and the context where the click happened.

Properties

• onShow

  Event<functionvoidvoid>

  Fired before showing a context menu on this webview. Can be used to disable this context menu by calling event.preventDefault().

  The onShow.addListener function looks like: (callback: function) => {...}

  • callback

    function

    The callback parameter looks like: (event: object) => void

    • event

      object

      • preventDefault

        void

        Call this to prevent showing the context menu.

        The preventDefault function looks like: () => {...}

• create

  void

  Creates a new context menu item. Note that if an error occurs during creation, you may not find out until the creation callback fires (the details will be in runtime.lastError).

  The create function looks like: (createProperties: object, callback?: function) => {...}

  • createProperties

    object

    The properties used to create the item

  • callback

    function optional

    The callback parameter looks like: () => void

  • returns

    string | number

    The ID of the newly created item.

• remove

  void

  Removes a context menu item.

  The remove function looks like: (menuItemId: string | number, callback?: function) => {...}

  • menuItemId

    string | number

    The ID of the context menu item to remove.

  • callback

    function optional

    The callback parameter looks like: () => void

• removeAll

  void

  Removes all context menu items added to this webview.

  The removeAll function looks like: (callback?: function) => {...}

  • callback

    function optional

    The callback parameter looks like: () => void

• update

  void

  Updates a previously created context menu item.

  The update function looks like: (id: string | number, updateProperties: object, callback?: function) => {...}

  • id

    string | number

    The ID of the item to update.

  • updateProperties

    object

    The properties to update. Accepts the same values as the create function.

  • callback

    function optional

    The callback parameter looks like: () => void

Properties

• checked

  boolean optional

  The state of a checkbox or radio item: true for selected and false for unselected. Only one radio item can be selected at a time in a given group of radio items.

• contexts

  [ContextType, ...ContextType[]] optional

  List of contexts this menu item will appear in.

• documentUrlPatterns

  string[] optional

  Lets you restrict the item to apply only to documents whose URL matches one of the given patterns. (This applies to frames as well.) For details on the format of a pattern, see Match Patterns.

• enabled

  boolean optional

  Whether this context menu item is enabled or disabled.

• parentId

  string | number optional

  The ID of a parent menu item; this makes the item a child of a previously added item. Note: You cannot change an item to be a child of one of its own descendants.

• targetUrlPatterns

  string[] optional

  Similar to documentUrlPatterns, but lets you filter based on the src attribute of img/audio/video tags and the href of anchor tags.

• title

  string optional

  The text to be displayed in the item

• type

  ItemType optional

  The type of menu item.

• onclick

  void optional

  A function that will be called back when the menu item is clicked.

  The onclick function looks like: (info: OnClickData) => {...}

  • info

    OnClickData

    Information about the item clicked and the context where the click happened.

Enum

Properties

• cancel

  void

  Reject the dialog. Equivalent to clicking Cancel in a confirm or prompt dialog.

  The cancel function looks like: () => {...}

• ok

  void

  Accept the dialog. Equivalent to clicking OK in an alert, confirm, or prompt dialog.

  The ok function looks like: (response?: string) => {...}

  • response

    string optional

    The response string to provide to the guest when accepting a prompt dialog.

Properties

• requestMethod

  string

  The HTTP request type (e.g. GET) associated with the download request.

• url

  string

  The requested download URL.

• allow

  void

  Allow the permission request.

  The allow function looks like: () => {...}

• deny

  void

  Deny the permission request. This is the default behavior if allow is not called.

  The deny function looks like: () => {...}

Properties

• url

  string

  The URL of the frame requesting access to local file system.

• allow

  void

  Allow the permission request.

  The allow function looks like: () => {...}

• deny

  void

  Deny the permission request.

  The deny function looks like: () => {...}

Properties

• activeMatchOrdinal

  number

  The ordinal number of the current match.

• canceled

  boolean

  Indicates whether this find request was canceled.

• numberOfMatches

  number

  The number of times searchText was matched on the page.

• selectionRect

  SelectionRect

  Describes a rectangle around the active match in screen coordinates.

Properties

• backward

  boolean optional

  Flag to find matches in reverse order. The default value is false.

• matchCase

  boolean optional

  Flag to match with case-sensitivity. The default value is false.

Properties

• origin

  string

  The origin of the frame inside the webview that initiated the fullscreen request.

• allow

  void

  Allow the permission request.

  The allow function looks like: () => {...}

• deny

  void

  Deny the permission request.

  The deny function looks like: () => {...}

Properties

• url

  string

  The URL of the frame requesting access to geolocation data.

• allow

  void

  Allow the permission request.

  The allow function looks like: () => {...}

• deny

  void

  Deny the permission request. This is the default behavior if allow is not called.

  The deny function looks like: () => {...}

Properties

• code

  string optional

  JavaScript or CSS code to inject.

  Warning: Be careful using the code parameter. Incorrect use of it may open your app to cross site scripting attacks.

• file

  string optional

  JavaScript or CSS file to inject.

Properties

• code

  string optional

  JavaScript code or CSS to be injected into matching pages.

• files

  string[] optional

  The list of JavaScript or CSS files to be injected into matching pages. These are injected in the order they appear in this array.

Properties

• identifier

  string

  The plugin's identifier string.

• name

  string

  The plugin's display name.

• allow

  void

  Allow the permission request. This is the default behavior if deny is not called..

  The allow function looks like: () => {...}

• deny

  void

  Deny the permission request.

  The deny function looks like: () => {...}

Properties

• url

  string

  The URL of the frame requesting access to user media.

• allow

  void

  Allow the permission request.

  The allow function looks like: () => {...}

• deny

  void

  Deny the permission request. This is the default behavior if allow is not called.

  The deny function looks like: () => {...}

Properties

• attach

  void

  Attach the requested target page to an existing webview element.

  The attach function looks like: (webview: object) => {...}

  • webview

    object

    The webview element to which the target page should be attached.

• discard

  void

  Cancel the new window request.

  The discard function looks like: () => {...}

Properties

• lastUnlockedBySelf

  boolean

  Whether or not the requesting frame was the most recent client to hold pointer lock.

• url

  string

  The URL of the frame requesting pointer lock.

• userGesture

  boolean

  Whether or not pointer lock was requested as a result of a user input gesture.

• allow

  void

  Allow the permission request.

  The allow function looks like: () => {...}

• deny

  void

  Deny the permission request. This is the default behavior if allow is not called.

  The deny function looks like: () => {...}

Properties

• height

  number

  Height of the rectangle.

• left

  number

  Distance from the left edge of the screen to the left edge of the rectangle.

• top

  number

  Distance from the top edge of the screen to the top edge of the rectangle.

• width

  number

  Width of the rectangle.

Enum

Type

Type

Type

Parameters

• contentScriptList

  [ContentScriptDetails, ...ContentScriptDetails[]]

  Details of the content scripts to add.

Parameters

• callback

  function optional

  Chrome 44+

  The callback parameter looks like: (success: boolean) => void

  • success

    boolean

    Indicates whether the navigation was successful.

Returns

• boolean

Returns

• boolean

Parameters

• options

  ImageDetails optional

• callback

  function

  The callback parameter looks like: (dataUrl: string) => void

  • dataUrl

    string

    A data URL which encodes an image of the visible area of the captured tab. May be assigned to the 'src' property of an HTML Image element for display.

Parameters

• options

  ClearDataOptions

  Options determining which data to clear.

• types

  ClearDataTypeSet

  The types of data to be cleared.

• callback

  function optional

  The callback parameter looks like: () => void

Parameters

• details

  InjectDetails

  Details of the script to run.

• callback

  function optional

  The callback parameter looks like: (result?: any[]) => void

  • result

    any[] optional

    The result of the script in every injected frame.

Parameters

• searchText

  string

  The string to find in the page.

• options

  FindOptions optional

  Options for the find request.

• callback

  function optional

  The callback parameter looks like: (results?: FindCallbackResults) => void

  • results

    FindCallbackResults optional

    Contains all of the results of the find request. results can be omitted if it is not utilized in the callback function body; for example, if the callback is only used to discern when the find request has completed.

Parameters

• callback

  function optional

  Chrome 44+

  The callback parameter looks like: (success: boolean) => void

  • success

    boolean

    Indicates whether the navigation was successful.

Parameters

• callback

  function

  The callback parameter looks like: (audible: boolean) => void

  • audible

    boolean

Returns

• number

Returns

• string

Parameters

• callback

  function

  The callback parameter looks like: (zoomFactor: number) => void

  • zoomFactor

    number

    The current zoom factor.

Parameters

• callback

  function

  The callback parameter looks like: (ZoomMode: ZoomMode) => void

  • ZoomMode

    ZoomMode

    The webview's current zoom mode.

Parameters

• relativeIndex

  number

  Relative history index to which the webview should be navigated. For example, a value of 2 will navigate forward 2 history entries if possible; a value of -3 will navigate backward 3 entries.

• callback

  function optional

  The callback parameter looks like: (success: boolean) => void

  • success

    boolean

    Indicates whether the navigation was successful.

Parameters

• details

  InjectDetails

  Details of the CSS to insert.

• callback

  function optional

  The callback parameter looks like: () => void

Parameters

• callback

  function

  The callback parameter looks like: (muted: boolean) => void

  • muted

    boolean

Parameters

• callback

  function

  The callback parameter looks like: (enabled: boolean) => void

  • enabled

    boolean

Parameters

• dataUrl

  string

  The data URL to load.

• baseUrl

  string

  The base URL that will be used for relative links.

• virtualUrl

  string optional

  The URL that will be displayed to the user (in the address bar).

Parameters

• scriptNameList

  string[] optional

  A list of names of content scripts that will be removed. If the list is empty, all the content scripts added to the webview will be removed.

Parameters

• mute

  boolean

  Mute audio value

Parameters

• enabled

  boolean

  Spatial navigation state value.

Parameters

• userAgent

  string

  The user agent string to use.

Parameters

• zoomFactor

  number

  The new zoom factor.

• callback

  function optional

  The callback parameter looks like: () => void

Parameters

• ZoomMode

  ZoomMode

  Defines how zooming is handled in the webview.

• callback

  function optional

  The callback parameter looks like: () => void

Parameters

• action

  "clear"
  | "keep"
  | "activate"
   optional

  Determines what to do with the active match after the find session has ended. clear will clear the highlighting over the active match; keep will keep the active match highlighted; activate will keep the active match highlighted and simulate a user click on that match. The default action is keep.

Parameters

• callback

  function

  The callback parameter looks like: () => void

Parameters

• callback

  function

  The callback parameter looks like: (level: number, message: string, line: number, sourceId: string) => void

  • level

    number

  • message

    string

  • line

    number

  • sourceId

    string

Parameters

• callback

  function

  The callback parameter looks like: () => void

Parameters

• callback

  function

  The callback parameter looks like: (messageType: "alert"
| "confirm"
| "prompt"
, messageText: string, dialog: DialogController) => void

  • messageType

    "alert"
    | "confirm"
    | "prompt"
    

  • messageText

    string

  • dialog

    DialogController

Parameters

• callback

  function

  The callback parameter looks like: (processID: number, reason: "normal"
| "abnormal"
| "crash"
| "kill"
) => void

  • processID

    number

  • reason

    "normal"
    | "abnormal"
    | "crash"
    | "kill"
    

Parameters

• callback

  function

  The callback parameter looks like: (searchText: string, numberOfMatches: number, activeMatchOrdinal: number, selectionRect: SelectionRect, canceled: boolean, finalUpdate: string) => void

  • searchText

    string

  • numberOfMatches

    number

  • activeMatchOrdinal

    number

  • selectionRect

    SelectionRect

  • canceled

    boolean

  • finalUpdate

    string

Parameters

• callback

  function

  The callback parameter looks like: (url: string, isTopLevel: boolean, code: number, reason: "ERR_ABORTED"
| "ERR_INVALID_URL"
| "ERR_DISALLOWED_URL_SCHEME"
| "ERR_BLOCKED_BY_CLIENT"
| "ERR_ADDRESS_UNREACHABLE"
| "ERR_EMPTY_RESPONSE"
| "ERR_FILE_NOT_FOUND"
| "ERR_UNKNOWN_URL_SCHEME"
) => void

  • url

    string

  • isTopLevel

    boolean

  • code

    number

  • reason

    "ERR_ABORTED"
    | "ERR_INVALID_URL"
    | "ERR_DISALLOWED_URL_SCHEME"
    | "ERR_BLOCKED_BY_CLIENT"
    | "ERR_ADDRESS_UNREACHABLE"
    | "ERR_EMPTY_RESPONSE"
    | "ERR_FILE_NOT_FOUND"
    | "ERR_UNKNOWN_URL_SCHEME"
    

Parameters

• callback

  function

  The callback parameter looks like: (url: string, isTopLevel: boolean) => void

  • url

    string

  • isTopLevel

    boolean

Parameters

• callback

  function

  The callback parameter looks like: (oldUrl: string, newUrl: string, isTopLevel: boolean) => void

  • oldUrl

    string

  • newUrl

    string

  • isTopLevel

    boolean

Parameters

• callback

  function

  The callback parameter looks like: (url: string, isTopLevel: boolean) => void

  • url

    string

  • isTopLevel

    boolean

Parameters

• callback

  function

  The callback parameter looks like: () => void

Parameters

• callback

  function

  The callback parameter looks like: (window: NewWindow, targetUrl: string, initialWidth: number, initialHeight: number, name: string, windowOpenDisposition: "ignore"
| "save_to_disk"
| "current_tab"
| "new_background_tab"
| "new_foreground_tab"
| "new_window"
| "new_popup"
) => void

  • window

    NewWindow

  • targetUrl

    string

  • initialWidth

    number

  • initialHeight

    number

  • name

    string

  • windowOpenDisposition

    "ignore"
    | "save_to_disk"
    | "current_tab"
    | "new_background_tab"
    | "new_foreground_tab"
    | "new_window"
    | "new_popup"
    

Parameters

• callback

  function

  The callback parameter looks like: (permission: "media"
| "geolocation"
| "pointerLock"
| "download"
| "loadplugin"
| "filesystem"
| "fullscreen"
, request: object) => void

  • permission

    "media"
    | "geolocation"
    | "pointerLock"
    | "download"
    | "loadplugin"
    | "filesystem"
    | "fullscreen"
    

  • request

    object

Parameters

• callback

  function

  The callback parameter looks like: (processID: number) => void

  • processID

    number

Parameters

• callback

  function

  The callback parameter looks like: (oldWidth: number, oldHeight: number, newWidth: number, newHeight: number) => void

  • oldWidth

    number

  • oldHeight

    number

  • newWidth

    number

  • newHeight

    number

Parameters

• callback

  function

  The callback parameter looks like: (processID: number) => void

  • processID

    number

Parameters

• callback

  function

  The callback parameter looks like: (oldZoomFactor: number, newZoomFactor: number) => void

  • oldZoomFactor

    number

  • newZoomFactor

    number