[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[GNUnet-SVN] [taler-wallet-webex] 01/10: use packaged type declarations
|
From: |
gnunet |
|
Subject: |
[GNUnet-SVN] [taler-wallet-webex] 01/10: use packaged type declarations |
|
Date: |
Sat, 17 Aug 2019 01:54:34 +0200 |
This is an automated email from the git hooks/post-receive script.
dold pushed a commit to branch master
in repository wallet-webex.
commit d10c42776a6b0deb1f366995cdb1666807106a1e
Author: Florian Dold <address@hidden>
AuthorDate: Fri Aug 16 19:20:18 2019 +0200
use packaged type declarations
---
decl/README | 2 -
decl/chrome/chrome.d.ts | 7697 ---------------------------------------
decl/filesystem/filesystem.d.ts | 548 ---
decl/filewriter/filewriter.d.ts | 176 -
decl/jed.d.ts | 18 -
decl/urijs.d.ts | 227 --
gulpfile.js | 10 +-
package.json | 4 +-
src/i18n.tsx | 2 +
9 files changed, 6 insertions(+), 8678 deletions(-)
diff --git a/decl/README b/decl/README
deleted file mode 100644
index 546ffa17..00000000
--- a/decl/README
+++ /dev/null
@@ -1,2 +0,0 @@
-This directory contains TypeScript declaration files that can't be installe via
-an npm package because they had to be modified.
diff --git a/decl/chrome/chrome.d.ts b/decl/chrome/chrome.d.ts
deleted file mode 100755
index 5a67322f..00000000
--- a/decl/chrome/chrome.d.ts
+++ /dev/null
@@ -1,7697 +0,0 @@
-// Type definitions for Chrome extension development
-// Project: http://developer.chrome.com/extensions/
-// Definitions by: Matthew Kimber <https://github.com/matthewkimber>, otiai10
<https://github.com/otiai10>, couven92 <https://github.com/couven92>, RReverser
<https://github.com/rreverser>
-// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-
-/// <reference path='../filesystem/filesystem.d.ts' />
-
-////////////////////
-// Global object
-////////////////////
-interface Window {
- chrome: typeof chrome;
-}
-
-////////////////////
-// Accessibility Features
-////////////////////
-/**
- * Use the chrome.accessibilityFeatures API to manage Chrome's accessibility
features. This API relies on the ChromeSetting prototype of the type API for
getting and setting individual accessibility features. In order to get feature
states the extension must request accessibilityFeatures.read permission. For
modifying feature state, the extension needs accessibilityFeatures.modify
permission. Note that accessibilityFeatures.modify does not imply
accessibilityFeatures.read permission.
- * Availability: Since Chrome 37.
- * Permissions: "accessibilityFeatures.read"
- * Important: This API works only on Chrome OS.
- */
-declare namespace chrome.accessibilityFeatures {
- interface AccessibilityFeaturesGetArg {
- /** Optional. Whether to return the value that applies to the
incognito session (default false). */
- incognito?: boolean;
- }
-
- interface AccessibilityFeaturesCallbackArg {
- /** The value of the setting. */
- value: any;
- /**
- * One of
- * • not_controllable: cannot be controlled by any extension
- * • controlled_by_other_extensions: controlled by extensions
with higher precedence
- * • controllable_by_this_extension: can be controlled by this
extension
- * • controlled_by_this_extension: controlled by this extension
- */
- levelOfControl: string;
- /** Optional. Whether the effective value is specific to the
incognito session. This property will only be present if the incognito property
in the details parameter of get() was true. */
- incognitoSpecific?: boolean;
- }
-
- interface AccessibilityFeaturesSetArg {
- /**
- * The value of the setting.
- * Note that every setting has a specific value type, which is
described together with the setting. An extension should not set a value of a
different type.
- */
- value: any;
- /**
- * Optional.
- * The scope of the ChromeSetting. One of
- * • regular: setting for the regular profile (which is
inherited by the incognito profile if not overridden elsewhere),
- * • regular_only: setting for the regular profile only (not
inherited by the incognito profile),
- * • incognito_persistent: setting for the incognito profile
that survives browser restarts (overrides regular preferences),
- * • incognito_session_only: setting for the incognito profile
that can only be set during an incognito session and is deleted when the
incognito session ends (overrides regular and incognito_persistent preferences).
- */
- scope?: string;
- }
-
- interface AccessibilityFeaturesClearArg {
- /**
- * Optional.
- * The scope of the ChromeSetting. One of
- * • regular: setting for the regular profile (which is
inherited by the incognito profile if not overridden elsewhere),
- * • regular_only: setting for the regular profile only (not
inherited by the incognito profile),
- * • incognito_persistent: setting for the incognito profile
that survives browser restarts (overrides regular preferences),
- * • incognito_session_only: setting for the incognito profile
that can only be set during an incognito session and is deleted when the
incognito session ends (overrides regular and incognito_persistent preferences).
- */
- scope?: string;
- }
-
- interface AccessibilityFeaturesSetting {
- /**
- * Gets the value of a setting.
- * @param details Which setting to consider.
- * @param callback The callback parameter should be a function
that looks like this:
- * function(object details) {...};
- */
- get(details: AccessibilityFeaturesGetArg, callback: (details:
AccessibilityFeaturesCallbackArg) => void): void;
- /**
- * Sets the value of a setting.
- * @param details Which setting to change.
- * @param callback Called at the completion of the set
operation.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function() {...};
- */
- set(details: AccessibilityFeaturesSetArg, callback?: () =>
void): void;
- /**
- * Clears the setting, restoring any default value.
- * @param details Which setting to clear.
- * @param callback Called at the completion of the clear
operation.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function() {...};
- */
- clear(details: AccessibilityFeaturesClearArg, callback?: () =>
void): void;
- }
-
- var spokenFeedback: AccessibilityFeaturesSetting;
- var largeCursor: AccessibilityFeaturesSetting;
- var stickyKeys: AccessibilityFeaturesSetting;
- var highContrast: AccessibilityFeaturesSetting;
- var screenMagnifier: AccessibilityFeaturesSetting;
- var autoclick: AccessibilityFeaturesSetting;
- var virtualKeyboard: AccessibilityFeaturesSetting;
- var animationPolicy: AccessibilityFeaturesSetting;
-}
-
-////////////////////
-// Alarms
-////////////////////
-/**
- * Use the chrome.alarms API to schedule code to run periodically or at a
specified time in the future.
- * Availability: Since Chrome 22.
- * Permissions: "alarms"
- */
-declare namespace chrome.alarms {
- interface AlarmCreateInfo {
- /** Optional. Length of time in minutes after which the onAlarm
event should fire. */
- delayInMinutes?: number;
- /** Optional. If set, the onAlarm event should fire every
periodInMinutes minutes after the initial event specified by when or
delayInMinutes. If not set, the alarm will only fire once. */
- periodInMinutes?: number;
- /** Optional. Time at which the alarm should fire, in
milliseconds past the epoch (e.g. Date.now() + n). */
- when?: number;
- }
-
- interface Alarm {
- /** Optional. If not null, the alarm is a repeating alarm and
will fire again in periodInMinutes minutes. */
- periodInMinutes?: number;
- /** Time at which this alarm was scheduled to fire, in
milliseconds past the epoch (e.g. Date.now() + n). For performance reasons, the
alarm may have been delayed an arbitrary amount beyond this. */
- scheduledTime: number;
- /** Name of this alarm. */
- name: string;
- }
-
- interface AlarmEvent extends chrome.events.Event<(alarm: Alarm) => void> {}
-
- /**
- * Creates an alarm. Near the time(s) specified by alarmInfo, the
onAlarm event is fired. If there is another alarm with the same name (or no
name if none is specified), it will be cancelled and replaced by this alarm.
- * In order to reduce the load on the user's machine, Chrome limits
alarms to at most once every 1 minute but may delay them an arbitrary amount
more. That is, setting delayInMinutes or periodInMinutes to less than 1 will
not be honored and will cause a warning. when can be set to less than 1 minute
after "now" without warning but won't actually cause the alarm to fire for at
least 1 minute.
- * To help you debug your app or extension, when you've loaded it
unpacked, there's no limit to how often the alarm can fire.
- * @param alarmInfo Describes when the alarm should fire. The initial
time must be specified by either when or delayInMinutes (but not both). If
periodInMinutes is set, the alarm will repeat every periodInMinutes minutes
after the initial event. If neither when or delayInMinutes is set for a
repeating alarm, periodInMinutes is used as the default for delayInMinutes.
- */
- export function create(alarmInfo: AlarmCreateInfo): void;
- /**
- * Creates an alarm. Near the time(s) specified by alarmInfo, the
onAlarm event is fired. If there is another alarm with the same name (or no
name if none is specified), it will be cancelled and replaced by this alarm.
- * In order to reduce the load on the user's machine, Chrome limits
alarms to at most once every 1 minute but may delay them an arbitrary amount
more. That is, setting delayInMinutes or periodInMinutes to less than 1 will
not be honored and will cause a warning. when can be set to less than 1 minute
after "now" without warning but won't actually cause the alarm to fire for at
least 1 minute.
- * To help you debug your app or extension, when you've loaded it
unpacked, there's no limit to how often the alarm can fire.
- * @param name Optional name to identify this alarm. Defaults to the
empty string.
- * @param alarmInfo Describes when the alarm should fire. The initial
time must be specified by either when or delayInMinutes (but not both). If
periodInMinutes is set, the alarm will repeat every periodInMinutes minutes
after the initial event. If neither when or delayInMinutes is set for a
repeating alarm, periodInMinutes is used as the default for delayInMinutes.
- */
- export function create(name: string, alarmInfo: AlarmCreateInfo): void;
- /**
- * Gets an array of all the alarms.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of Alarm alarms) {...};
- */
- export function getAll(callback: (alarms: Alarm[]) => void): void;
- /**
- * Clears all alarms.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(boolean wasCleared) {...};
- */
- export function clearAll(callback?: (wasCleared: boolean) => void): void;
- /**
- * Clears the alarm with the given name.
- * @param name The name of the alarm to clear. Defaults to the empty
string.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(boolean wasCleared) {...};
- */
- export function clear(name?: string, callback?: (wasCleared: boolean) =>
void): void;
- /**
- * Clears the alarm without a name.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(boolean wasCleared) {...};
- */
- export function clear(callback: (wasCleared: boolean) => void): void;
- /**
- * Retrieves details about the specified alarm.
- * @param callback The callback parameter should be a function that
looks like this:
- * function( Alarm alarm) {...};
- */
- export function get(callback: (alarm: Alarm) => void): void;
- /**
- * Retrieves details about the specified alarm.
- * @param name The name of the alarm to get. Defaults to the empty
string.
- * @param callback The callback parameter should be a function that
looks like this:
- * function( Alarm alarm) {...};
- */
- export function get(name: string, callback: (alarm: Alarm) => void): void;
-
- /** Fired when an alarm has elapsed. Useful for event pages. */
- var onAlarm: AlarmEvent;
-}
-
-/**
- * Use the chrome.browser API to interact with the Chrome browser associated
with
- * the current application and Chrome profile.
- */
-declare namespace chrome.browser {
- interface Options {
- /** The URL to navigate to when the new tab is initially opened. */
- url: string;
- }
-
- /**
- * Opens a new tab in a browser window associated with the current
application
- * and Chrome profile. If no browser window for the Chrome profile is
opened,
- * a new one is opened prior to creating the new tab.
- * @param options Configures how the tab should be opened.
- * @param callback Called when the tab was successfully
- * created, or failed to be created. If failed, runtime.lastError will be
set.
- */
- export function openTab(options: Options, callback: () => void): void;
-
- /**
- * Opens a new tab in a browser window associated with the current
application
- * and Chrome profile. If no browser window for the Chrome profile is
opened,
- * a new one is opened prior to creating the new tab. Since Chrome 42
only.
- * @param options Configures how the tab should be opened.
- */
- export function openTab(options: Options): void;
-}
-
-////////////////////
-// Bookmarks
-////////////////////
-/**
- * Use the chrome.bookmarks API to create, organize, and otherwise manipulate
bookmarks. Also see Override Pages, which you can use to create a custom
Bookmark Manager page.
- * Availability: Since Chrome 5.
- * Permissions: "bookmarks"
- */
-declare namespace chrome.bookmarks {
- /** A node (either a bookmark or a folder) in the bookmark tree. Child
nodes are ordered within their parent folder. */
- interface BookmarkTreeNode {
- /** Optional. The 0-based position of this node within its
parent folder. */
- index?: number;
- /** Optional. When this node was created, in milliseconds since
the epoch (new Date(dateAdded)). */
- dateAdded?: number;
- /** The text displayed for the node. */
- title: string;
- /** Optional. The URL navigated to when a user clicks the
bookmark. Omitted for folders. */
- url?: string;
- /** Optional. When the contents of this folder last changed, in
milliseconds since the epoch. */
- dateGroupModified?: number;
- /** The unique identifier for the node. IDs are unique within
the current profile, and they remain valid even after the browser is restarted.
*/
- id: string;
- /** Optional. The id of the parent folder. Omitted for the root
node. */
- parentId?: string;
- /** Optional. An ordered list of children of this node. */
- children?: BookmarkTreeNode[];
- /**
- * Optional.
- * Since Chrome 37.
- * Indicates the reason why this node is unmodifiable. The
managed value indicates that this node was configured by the system
administrator or by the custodian of a supervised user. Omitted if the node can
be modified by the user and the extension (default).
- */
- unmodifiable?: any;
- }
-
- interface BookmarkRemoveInfo {
- index: number;
- parentId: string;
- }
-
- interface BookmarkMoveInfo {
- index: number;
- oldIndex: number;
- parentId: string;
- oldParentId: string;
- }
-
- interface BookmarkChangeInfo {
- url?: string;
- title: string;
- }
-
- interface BookmarkReorderInfo {
- childIds: string[];
- }
-
- interface BookmarkRemovedEvent extends chrome.events.Event<(id: string,
removeInfo: BookmarkRemoveInfo) => void> {}
-
- interface BookmarkImportEndedEvent extends chrome.events.Event<() => void>
{}
-
- interface BookmarkMovedEvent extends chrome.events.Event<(id: string,
moveInfo: BookmarkMoveInfo) => void> {}
-
- interface BookmarkImportBeganEvent extends chrome.events.Event<() => void>
{}
-
- interface BookmarkChangedEvent extends chrome.events.Event<(id: string,
changeInfo: BookmarkChangeInfo) => void> {}
-
- interface BookmarkCreatedEvent extends chrome.events.Event<(id: string,
bookmark: BookmarkTreeNode) => void> {}
-
- interface BookmarkChildrenReordered extends chrome.events.Event<(id:
string, reorderInfo: BookmarkReorderInfo) => void> {}
-
- interface BookmarkSearchQuery {
- query?: string;
- url?: string;
- title?: string;
- }
-
- interface BookmarkCreateArg {
- /** Optional. Defaults to the Other Bookmarks folder. */
- parentId?: string;
- index?: number;
- title?: string;
- url?: string;
- }
-
- interface BookmarkDestinationArg {
- parentId?: string;
- index?: number;
- }
-
- interface BookmarkChangesArg {
- title?: string;
- url?: string;
- }
-
- /** @deprecated since Chrome 38. Bookmark write operations are no
longer limited by Chrome. */
- var MAX_WRITE_OPERATIONS_PER_HOUR: number;
- /** @deprecated since Chrome 38. Bookmark write operations are no
longer limited by Chrome. */
- var MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE: number;
-
- /**
- * Searches for BookmarkTreeNodes matching the given query. Queries
specified with an object produce BookmarkTreeNodes matching all specified
properties.
- * @param query A string of words and quoted phrases that are matched
against bookmark URLs and titles.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of BookmarkTreeNode results) {...};
- */
- export function search(query: string, callback: (results:
BookmarkTreeNode[]) => void): void;
- /**
- * Searches for BookmarkTreeNodes matching the given query. Queries
specified with an object produce BookmarkTreeNodes matching all specified
properties.
- * @param query An object with one or more of the properties query,
url, and title specified. Bookmarks matching all specified properties will be
produced.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of BookmarkTreeNode results) {...};
- */
- export function search(query: BookmarkSearchQuery, callback: (results:
BookmarkTreeNode[]) => void): void;
- /**
- * Retrieves the entire Bookmarks hierarchy.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of BookmarkTreeNode results) {...};
- */
- export function getTree(callback: (results: BookmarkTreeNode[]) => void):
void;
- /**
- * Retrieves the recently added bookmarks.
- * @param numberOfItems The maximum number of items to return.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of BookmarkTreeNode results) {...};
- */
- export function getRecent(numberOfItems: number, callback: (results:
BookmarkTreeNode[]) => void): void;
- /**
- * Retrieves the specified BookmarkTreeNode.
- * @param id A single string-valued id
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of BookmarkTreeNode results) {...};
- */
- export function get(id: string, callback: (results: BookmarkTreeNode[]) =>
void): void;
- /**
- * Retrieves the specified BookmarkTreeNode.
- * @param idList An array of string-valued ids
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of BookmarkTreeNode results) {...};
- */
- export function get(idList: string[], callback: (results:
BookmarkTreeNode[]) => void): void;
- /**
- * Creates a bookmark or folder under the specified parentId. If url is
NULL or missing, it will be a folder.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function( BookmarkTreeNode result) {...};
- */
- export function create(bookmark: BookmarkCreateArg, callback?: (result:
BookmarkTreeNode) => void): void;
- /**
- * Moves the specified BookmarkTreeNode to the provided location.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function( BookmarkTreeNode result) {...};
- */
- export function move(id: string, destination: BookmarkDestinationArg,
callback?: (result: BookmarkTreeNode) => void): void;
- /**
- * Updates the properties of a bookmark or folder. Specify only the
properties that you want to change; unspecified properties will be left
unchanged. Note: Currently, only 'title' and 'url' are supported.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function( BookmarkTreeNode result) {...};
- */
- export function update(id: string, changes: BookmarkChangesArg, callback?:
(result: BookmarkTreeNode) => void): void;
- /**
- * Removes a bookmark or an empty bookmark folder.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function remove(id: string, callback?: Function): void;
- /**
- * Retrieves the children of the specified BookmarkTreeNode id.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of BookmarkTreeNode results) {...};
- */
- export function getChildren(id: string, callback: (results:
BookmarkTreeNode[]) => void): void;
- /**
- * Since Chrome 14.
- * Retrieves part of the Bookmarks hierarchy, starting at the specified
node.
- * @param id The ID of the root of the subtree to retrieve.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of BookmarkTreeNode results) {...};
- */
- export function getSubTree(id: string, callback: (results:
BookmarkTreeNode[]) => void): void;
- /**
- * Recursively removes a bookmark folder.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function removeTree(id: string, callback?: Function): void;
-
- /** Fired when a bookmark or folder is removed. When a folder is
removed recursively, a single notification is fired for the folder, and none
for its contents. */
- var onRemoved: BookmarkRemovedEvent;
- /** Fired when a bookmark import session is ended. */
- var onImportEnded: BookmarkImportEndedEvent;
- /** Fired when a bookmark import session is begun. Expensive observers
should ignore onCreated updates until onImportEnded is fired. Observers should
still handle other notifications immediately. */
- var onImportBegan: BookmarkImportBeganEvent;
- /** Fired when a bookmark or folder changes. Note: Currently, only
title and url changes trigger this. */
- var onChanged: BookmarkChangedEvent;
- /** Fired when a bookmark or folder is moved to a different parent
folder. */
- var onMoved: BookmarkMovedEvent;
- /** Fired when a bookmark or folder is created. */
- var onCreated: BookmarkCreatedEvent;
- /** Fired when the children of a folder have changed their order due to
the order being sorted in the UI. This is not called as a result of a move(). */
- var onChildrenReordered: BookmarkChildrenReordered;
-}
-
-////////////////////
-// Browser Action
-////////////////////
-/**
- * Use browser actions to put icons in the main Google Chrome toolbar, to the
right of the address bar. In addition to its icon, a browser action can also
have a tooltip, a badge, and a popup.
- * Availability: Since Chrome 5.
- * Manifest: "browser_action": {...}
- */
-declare namespace chrome.browserAction {
- interface BadgeBackgroundColorDetails {
- /** An array of four integers in the range [0,255] that make up
the RGBA color of the badge. For example, opaque red is [255, 0, 0, 255]. Can
also be a string with a CSS value, with opaque red being #FF0000 or #F00. */
- color: any;
- /** Optional. Limits the change to when a particular tab is
selected. Automatically resets when the tab is closed. */
- tabId?: number;
- }
-
- interface BadgeTextDetails {
- /** Any number of characters can be passed, but only about four
can fit in the space. */
- text: string;
- /** Optional. Limits the change to when a particular tab is
selected. Automatically resets when the tab is closed. */
- tabId?: number;
- }
-
- interface TitleDetails {
- /** The string the browser action should display when moused
over. */
- title: string;
- /** Optional. Limits the change to when a particular tab is
selected. Automatically resets when the tab is closed. */
- tabId?: number;
- }
-
- interface TabDetails {
- /** Optional. Specify the tab to get the information. If no tab
is specified, the non-tab-specific information is returned. */
- tabId?: number;
- }
-
- interface TabIconDetails {
- /** Optional. Either a relative image path or a dictionary
{size -> relative image path} pointing to icon to be set. If the icon is
specified as a dictionary, the actual image to be used is chosen depending on
screen's pixel density. If the number of image pixels that fit into one screen
space unit equals scale, then image with size scale * 19 will be selected.
Initially only scales 1 and 2 will be supported. At least one image must be
specified. Note that 'details.path = foo' is equiv [...]
- path?: any;
- /** Optional. Limits the change to when a particular tab is
selected. Automatically resets when the tab is closed. */
- tabId?: number;
- /** Optional. Either an ImageData object or a dictionary {size
-> ImageData} representing icon to be set. If the icon is specified as a
dictionary, the actual image to be used is chosen depending on screen's pixel
density. If the number of image pixels that fit into one screen space unit
equals scale, then image with size scale * 19 will be selected. Initially only
scales 1 and 2 will be supported. At least one image must be specified. Note
that 'details.imageData = foo' is equivalent [...]
- imageData?: ImageData;
- }
-
- interface PopupDetails {
- /** Optional. Limits the change to when a particular tab is
selected. Automatically resets when the tab is closed. */
- tabId?: number;
- /** The html file to show in a popup. If set to the empty
string (''), no popup is shown. */
- popup: string;
- }
-
- interface BrowserClickedEvent extends chrome.events.Event<(tab:
chrome.tabs.Tab) => void> {}
-
- /**
- * Since Chrome 22.
- * Enables the browser action for a tab. By default, browser actions
are enabled.
- * @param tabId The id of the tab for which you want to modify the
browser action.
- */
- export function enable(tabId?: number): void;
- /** Sets the background color for the badge. */
- export function setBadgeBackgroundColor(details:
BadgeBackgroundColorDetails): void;
- /** Sets the badge text for the browser action. The badge is displayed
on top of the icon. */
- export function setBadgeText(details: BadgeTextDetails): void;
- /** Sets the title of the browser action. This shows up in the tooltip.
*/
- export function setTitle(details: TitleDetails): void;
- /**
- * Since Chrome 19.
- * Gets the badge text of the browser action. If no tab is specified,
the non-tab-specific badge text is returned.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(string result) {...};
- */
- export function getBadgeText(details: TabDetails, callback: (result:
string) => void): void;
- /** Sets the html document to be opened as a popup when the user clicks
on the browser action's icon. */
- export function setPopup(details: PopupDetails): void;
- /**
- * Since Chrome 22.
- * Disables the browser action for a tab.
- * @param tabId The id of the tab for which you want to modify the
browser action.
- */
- export function disable(tabId?: number): void;
- /**
- * Since Chrome 19.
- * Gets the title of the browser action.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(string result) {...};
- */
- export function getTitle(details: TabDetails, callback: (result: string)
=> void): void;
- /**
- * Since Chrome 19.
- * Gets the background color of the browser action.
- * @param callback The callback parameter should be a function that
looks like this:
- * function( ColorArray result) {...};
- */
- export function getBadgeBackgroundColor(details: TabDetails, callback:
(result: number[]) => void): void;
- /**
- * Since Chrome 19.
- * Gets the html document set as the popup for this browser action.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(string result) {...};
- */
- export function getPopup(details: TabDetails, callback: (result: string)
=> void): void;
- /**
- * Sets the icon for the browser action. The icon can be specified
either as the path to an image file or as the pixel data from a canvas element,
or as dictionary of either one of those. Either the path or the imageData
property must be specified.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function setIcon(details: TabIconDetails, callback?: Function):
void;
-
- /** Fired when a browser action icon is clicked. This event will not
fire if the browser action has a popup. */
- var onClicked: BrowserClickedEvent;
-}
-
-////////////////////
-// Browsing Data
-////////////////////
-/**
- * Use the chrome.browsingData API to remove browsing data from a user's local
profile.
- * Availability: Since Chrome 19.
- * Permissions: "browsingData"
- */
-declare namespace chrome.browsingData {
- interface OriginTypes {
- /** Optional. Websites that have been installed as hosted
applications (be careful!). */
- protectedWeb?: boolean;
- /** Optional. Extensions and packaged applications a user has
installed (be _really_ careful!). */
- extension?: boolean;
- /** Optional. Normal websites. */
- unprotectedWeb?: boolean;
- }
-
- /** Options that determine exactly what data will be removed. */
- interface RemovalOptions {
- /**
- * Optional.
- * Since Chrome 21.
- * An object whose properties specify which origin types ought
to be cleared. If this object isn't specified, it defaults to clearing only
"unprotected" origins. Please ensure that you really want to remove application
data before adding 'protectedWeb' or 'extensions'.
- */
- originTypes?: OriginTypes;
- /** Optional. Remove 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). */
- since?: number;
- }
-
- /**
- * Since Chrome 27.
- * A set of data types. Missing data types are interpreted as false.
- */
- interface DataTypeSet {
- /** Optional. Websites' WebSQL data. */
- webSQL?: boolean;
- /** Optional. Websites' IndexedDB data. */
- indexedDB?: boolean;
- /** Optional. The browser's cookies. */
- cookies?: boolean;
- /** Optional. Stored passwords. */
- passwords?: boolean;
- /** Optional. Server-bound certificates. */
- serverBoundCertificates?: boolean;
- /** Optional. The browser's download list. */
- downloads?: boolean;
- /** Optional. The browser's cache. Note: when removing data,
this clears the entire cache: it is not limited to the range you specify. */
- cache?: boolean;
- /** Optional. Websites' appcaches. */
- appcache?: boolean;
- /** Optional. Websites' file systems. */
- fileSystems?: boolean;
- /** Optional. Plugins' data. */
- pluginData?: boolean;
- /** Optional. Websites' local storage data. */
- localStorage?: boolean;
- /** Optional. The browser's stored form data. */
- formData?: boolean;
- /** Optional. The browser's history. */
- history?: boolean;
- /**
- * Optional.
- * Since Chrome 39.
- * Service Workers.
- */
- serviceWorkers?: boolean;
- }
-
- interface SettingsCallback {
- options: RemovalOptions;
- /** All of the types will be present in the result, with values
of true if they are both selected to be removed and permitted to be removed,
otherwise false. */
- dataToRemove: DataTypeSet;
- /** All of the types will be present in the result, with values
of true if they are permitted to be removed (e.g., by enterprise policy) and
false if not. */
- dataRemovalPermitted: DataTypeSet;
- }
-
- /**
- * Since Chrome 26.
- * Reports which types of data are currently selected in the 'Clear
browsing data' settings UI. Note: some of the data types included in this API
are not available in the settings UI, and some UI settings control more than
one data type listed here.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(object result) {...};
- */
- export function settings(callback: (result: SettingsCallback) => void):
void;
- /**
- * Clears plugins' data.
- * @param callback Called when plugins' data has been cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removePluginData(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears the browser's stored form data (autofill).
- * @param callback Called when the browser's form data has been cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeFormData(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears websites' file system data.
- * @param callback Called when websites' file systems have been cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeFileSystems(options: RemovalOptions, callback?: ()
=> void): void;
- /**
- * Clears various types of browsing data stored in a user's profile.
- * @param dataToRemove The set of data types to remove.
- * @param callback Called when deletion has completed.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function remove(options: RemovalOptions, dataToRemove: DataTypeSet,
callback?: () => void): void;
- /**
- * Clears the browser's stored passwords.
- * @param callback Called when the browser's passwords have been
cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removePasswords(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears the browser's cookies and server-bound certificates modified
within a particular timeframe.
- * @param callback Called when the browser's cookies and server-bound
certificates have been cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeCookies(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears websites' WebSQL data.
- * @param callback Called when websites' WebSQL databases have been
cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeWebSQL(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears websites' appcache data.
- * @param callback Called when websites' appcache data has been cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeAppcache(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears the browser's list of downloaded files (not the downloaded
files themselves).
- * @param callback Called when the browser's list of downloaded files
has been cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeDownloads(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears websites' local storage data.
- * @param callback Called when websites' local storage has been cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeLocalStorage(options: RemovalOptions, callback?: ()
=> void): void;
- /**
- * Clears the browser's cache.
- * @param callback Called when the browser's cache has been cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeCache(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears the browser's history.
- * @param callback Called when the browser's history has cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeHistory(options: RemovalOptions, callback?: () =>
void): void;
- /**
- * Clears websites' IndexedDB data.
- * @param callback Called when websites' IndexedDB data has been
cleared.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeIndexedDB(options: RemovalOptions, callback?: () =>
void): void;
-}
-
-////////////////////
-// Commands
-////////////////////
-/**
- * Use the commands API to add keyboard shortcuts that trigger actions in your
extension, for example, an action to open the browser action or send a command
to the extension.
- * Availability: Since Chrome 25.
- * Manifest: "commands": {...}
- */
-declare namespace chrome.commands {
- interface Command {
- /** Optional. The name of the Extension Command */
- name?: string;
- /** Optional. The Extension Command description */
- description?: string;
- /** Optional. The shortcut active for this command, or blank if
not active. */
- shortcut?: string;
- }
-
- interface CommandEvent extends chrome.events.Event<(command: string) =>
void> {}
-
- /**
- * Returns all the registered extension commands for this extension and
their shortcut (if active).
- * @param callback Called to return the registered commands.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(array of Command commands) {...};
- */
- export function getAll(callback: (commands: Command[]) => void): void;
-
- /** Fired when a registered command is activated using a keyboard
shortcut. */
- var onCommand: CommandEvent;
-}
-
-////////////////////
-// Content Settings
-////////////////////
-/**
- * Use the chrome.contentSettings API to change settings that control whether
websites can use features such as cookies, JavaScript, and plugins. More
generally speaking, content settings allow you to customize Chrome's behavior
on a per-site basis instead of globally.
- * Availability: Since Chrome 16.
- * Permissions: "contentSettings"
- */
-declare namespace chrome.contentSettings {
- interface ClearDetails {
- /**
- * Optional.
- * Where to clear the setting (default: regular).
- * The scope of the ContentSetting. One of
- * * regular: setting for regular profile (which is inherited
by the incognito profile if not overridden elsewhere),
- * * incognito_session_only: setting for incognito profile that
can only be set during an incognito session and is deleted when the incognito
session ends (overrides regular settings).
- */
- scope?: string;
- }
-
- interface SetDetails {
- /** Optional. The resource identifier for the content type. */
- resourceIdentifier?: ResourceIdentifier;
- /** The setting applied by this rule. See the description of
the individual ContentSetting objects for the possible values. */
- setting: any;
- /** Optional. The pattern for the secondary URL. Defaults to
matching all URLs. For details on the format of a pattern, see Content Setting
Patterns. */
- secondaryPattern?: string;
- /** Optional. Where to set the setting (default: regular). */
- scope?: string;
- /** The pattern for the primary URL. For details on the format
of a pattern, see Content Setting Patterns. */
- primaryPattern: string;
- }
-
- interface GetDetails {
- /** Optional. The secondary URL for which the content setting
should be retrieved. Defaults to the primary URL. Note that the meaning of a
secondary URL depends on the content type, and not all content types use
secondary URLs. */
- secondaryUrl?: string;
- /** Optional. A more specific identifier of the type of content
for which the settings should be retrieved. */
- resourceIdentifier?: ResourceIdentifier;
- /** Optional. Whether to check the content settings for an
incognito session. (default false) */
- incognito?: boolean;
- /** The primary URL for which the content setting should be
retrieved. Note that the meaning of a primary URL depends on the content type.
*/
- primaryUrl: string;
- }
-
- interface ReturnedDetails {
- /** The content setting. See the description of the individual
ContentSetting objects for the possible values. */
- setting: any;
- }
-
- interface ContentSetting {
- /**
- * Clear all content setting rules set by this extension.
- * @param callback If you specify the callback parameter, it
should be a function that looks like this:
- * function() {...};
- */
- clear(details: ClearDetails, callback?: () => void): void;
- /**
- * Applies a new content setting rule.
- * @param callback If you specify the callback parameter, it
should be a function that looks like this:
- * function() {...};
- */
- set(details: SetDetails, callback?: () => void): void;
- /**
- * @param callback The callback parameter should be a function
that looks like this:
- * function(array of ResourceIdentifier resourceIdentifiers)
{...};
- * Parameter resourceIdentifiers: A list of resource
identifiers for this content type, or undefined if this content type does not
use resource identifiers.
- */
- getResourceIdentifiers(callback: (resourceIdentifiers?:
ResourceIdentifier[]) => void): void;
- /**
- * Gets the current content setting for a given pair of URLs.
- * @param callback The callback parameter should be a function
that looks like this:
- * function(object details) {...};
- */
- get(details: GetDetails, callback: (details: ReturnedDetails) =>
void): void;
- }
-
- /** The only content type using resource identifiers is
contentSettings.plugins. For more information, see Resource Identifiers. */
- interface ResourceIdentifier {
- /** The resource identifier for the given content type. */
- id: string;
- /** Optional. A human readable description of the resource. */
- description?: string;
- }
-
- /**
- * Whether to allow cookies and other local data to be set by websites.
One of
- * allow: Accept cookies,
- * block: Block cookies,
- * session_only: Accept cookies only for the current session.
- * Default is allow.
- * The primary URL is the URL representing the cookie origin. The
secondary URL is the URL of the top-level frame.
- */
- var cookies: ContentSetting;
- /**
- * Whether to allow sites to show pop-ups. One of
- * allow: Allow sites to show pop-ups,
- * block: Don't allow sites to show pop-ups.
- * Default is block.
- * The primary URL is the URL of the top-level frame. The secondary URL
is not used.
- */
- var popups: ContentSetting;
- /**
- * Whether to run JavaScript. One of
- * allow: Run JavaScript,
- * block: Don't run JavaScript.
- * Default is allow.
- * The primary URL is the URL of the top-level frame. The secondary URL
is not used.
- */
- var javascript: ContentSetting;
- /**
- * Whether to allow sites to show desktop notifications. One of
- * allow: Allow sites to show desktop notifications,
- * block: Don't allow sites to show desktop notifications,
- * ask: Ask when a site wants to show desktop notifications.
- * Default is ask.
- * The primary URL is the URL of the document which wants to show the
notification. The secondary URL is not used.
- */
- var notifications: ContentSetting;
- /**
- * Whether to run plugins. One of
- * allow: Run plugins automatically,
- * block: Don't run plugins automatically,
- * detect_important_content: Only run automatically those plugins that
are detected as the website's main content.
- * Default is allow.
- * The primary URL is the URL of the top-level frame. The secondary URL
is not used.
- */
- var plugins: ContentSetting;
- /**
- * Whether to show images. One of
- * allow: Show images,
- * block: Don't show images.
- * Default is allow.
- * The primary URL is the URL of the top-level frame. The secondary URL
is the URL of the image.
- */
- var images: ContentSetting;
- /**
- * Since Chrome 42.
- * Whether to allow Geolocation. One of
- * allow: Allow sites to track your physical location,
- * block: Don't allow sites to track your physical location,
- * ask: Ask before allowing sites to track your physical location.
- * Default is ask.
- * The primary URL is the URL of the document which requested location
data. The secondary URL is the URL of the top-level frame (which may or may not
differ from the requesting URL).
- */
- var location: ContentSetting;
- /**
- * Since Chrome 42.
- * Whether to allow sites to toggle the fullscreen mode. One of
- * allow: Allow sites to toggle the fullscreen mode,
- * ask: Ask when a site wants to toggle the fullscreen mode.
- * Default is ask.
- * The primary URL is the URL of the document which requested to toggle
the fullscreen mode. The secondary URL is the URL of the top-level frame (which
may or may not differ from the requesting URL).
- */
- var fullscreen: ContentSetting;
- /**
- * Since Chrome 42.
- * Whether to allow sites to disable the mouse cursor. One of
- * allow: Allow sites to disable the mouse cursor,
- * block: Don't allow sites to disable the mouse cursor,
- * ask: Ask when a site wants to disable the mouse cursor.
- * Default is ask.
- * The primary URL is the URL of the top-level frame. The secondary URL
is not used.
- */
- var mouselock: ContentSetting;
- /**
- * Since Chrome 42.
- * Whether to allow sites to run plugins unsandboxed. One of
- * allow: Allow sites to run plugins unsandboxed,
- * block: Don't allow sites to run plugins unsandboxed,
- * ask: Ask when a site wants to run a plugin unsandboxed.
- * Default is ask.
- * The primary URL is the URL of the top-level frame. The secondary URL
is not used.
- */
- var unsandboxedPlugins: ContentSetting;
- /**
- * Since Chrome 42.
- * Whether to allow sites to download multiple files automatically. One
of
- * allow: Allow sites to download multiple files automatically,
- * block: Don't allow sites to download multiple files automatically,
- * ask: Ask when a site wants to download files automatically after the
first file.
- * Default is ask.
- * The primary URL is the URL of the top-level frame. The secondary URL
is not used.
- */
- var automaticDownloads: ContentSetting;
-}
-
-////////////////////
-// Context Menus
-////////////////////
-/**
- * Use the chrome.contextMenus API to add items to Google Chrome's context
menu. You can choose what types of objects your context menu additions apply
to, such as images, hyperlinks, and pages.
- * Availability: Since Chrome 6.
- * Permissions: "contextMenus"
- */
-declare namespace chrome.contextMenus {
- interface OnClickData {
- /**
- * Optional.
- * Since Chrome 35.
- * The text for the context selection, if any.
- */
- selectionText?: string;
- /**
- * Optional.
- * Since Chrome 35.
- * A flag indicating the state of a checkbox or radio item
after it is clicked.
- */
- checked?: boolean;
- /**
- * Since Chrome 35.
- * The ID of the menu item that was clicked.
- */
- menuItemId: any;
- /**
- * Optional.
- * Since Chrome 35.
- * The URL of the frame of the element where the context menu
was clicked, if it was in a frame.
- */
- frameUrl?: string;
- /**
- * Since Chrome 35.
- * A flag indicating whether the element is editable (text
input, textarea, etc.).
- */
- editable: boolean;
- /**
- * Optional.
- * Since Chrome 35.
- * One of 'image', 'video', or 'audio' if the context menu was
activated on one of these types of elements.
- */
- mediaType?: string;
- /**
- * Optional.
- * Since Chrome 35.
- * A flag indicating the state of a checkbox or radio item
before it was clicked.
- */
- wasChecked?: boolean;
- /**
- * Since Chrome 35.
- * The URL of the page where the menu item was clicked. This
property is not set if the click occured in a context where there is no current
page, such as in a launcher context menu.
- */
- pageUrl: string;
- /**
- * Optional.
- * Since Chrome 35.
- * If the element is a link, the URL it points to.
- */
- linkUrl?: string;
- /**
- * Optional.
- * Since Chrome 35.
- * The parent ID, if any, for the item clicked.
- */
- parentMenuItemId?: any;
- /**
- * Optional.
- * Since Chrome 35.
- * Will be present for elements with a 'src' URL.
- */
- srcUrl?: string;
- }
-
- interface CreateProperties {
- /** 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. */
- documentUrlPatterns?: string[];
- /** 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. */
- checked?: boolean;
- /** 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". */
- title?: string;
- /** Optional. List of contexts this menu item will appear in.
Defaults to ['page'] if not specified. */
- contexts?: string[];
- /**
- * Optional.
- * Since Chrome 20.
- * Whether this context menu item is enabled or disabled.
Defaults to true.
- */
- enabled?: boolean;
- /** Optional. Similar to documentUrlPatterns, but lets you
filter based on the src attribute of img/audio/video tags and the href of
anchor tags. */
- targetUrlPatterns?: string[];
- /**
- * Optional.
- * A function that will be called back when the menu item is
clicked. Event pages cannot use this; instead, they should register a listener
for chrome.contextMenus.onClicked.
- * @param info Information sent when a context menu item is
clicked.
- * @param tab The details of the tab where the click took
place. Note: this parameter only present for extensions.
- */
- onclick?: (info: OnClickData, tab: chrome.tabs.Tab) => void;
- /** Optional. The ID of a parent menu item; this makes the item
a child of a previously added item. */
- parentId?: any;
- /** Optional. The type of menu item. Defaults to 'normal' if
not specified. */
- type?: string;
- /**
- * Optional.
- * Since Chrome 21.
- * The unique ID to assign to this item. Mandatory for event
pages. Cannot be the same as another ID for this extension.
- */
- id?: string;
- }
-
- interface UpdateProperties {
- documentUrlPatterns?: string[];
- checked?: boolean;
- title?: string;
- contexts?: string[];
- /** Optional. Since Chrome 20. */
- enabled?: boolean;
- targetUrlPatterns?: string[];
- onclick?: Function;
- /** Optional. Note: You cannot change an item to be a child of
one of its own descendants. */
- parentId?: any;
- type?: string;
- }
-
- interface MenuClickedEvent extends chrome.events.Event<(info: OnClickData,
tab?: chrome.tabs.Tab) => void> {}
-
- /**
- * Since Chrome 38.
- * The maximum number of top level extension items that can be added to
an extension action context menu. Any items beyond this limit will be ignored.
- */
- var ACTION_MENU_TOP_LEVEL_LIMIT: number;
-
- /**
- * Removes all context menu items added by this extension.
- * @param callback Called when removal is complete.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeAll(callback?: () => void): 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 chrome.runtime.lastError).
- * @param callback Called when the item has been created in the
browser. If there were any problems creating the item, details will be
available in chrome.runtime.lastError.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function create(createProperties: CreateProperties, callback?: ()
=> void): void;
- /**
- * Updates a previously created context menu item.
- * @param id The ID of the item to update.
- * @param updateProperties The properties to update. Accepts the same
values as the create function.
- * @param callback Called when the context menu has been updated.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function update(id: string, updateProperties: UpdateProperties,
callback?: () => void): void;
- /**
- * Updates a previously created context menu item.
- * @param id The ID of the item to update.
- * @param updateProperties The properties to update. Accepts the same
values as the create function.
- * @param callback Called when the context menu has been updated.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function update(id: number, updateProperties: UpdateProperties,
callback?: () => void): void;
- /**
- * Removes a context menu item.
- * @param menuItemId The ID of the context menu item to remove.
- * @param callback Called when the context menu has been removed.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function remove(menuItemId: string, callback?: () => void): void;
- /**
- * Removes a context menu item.
- * @param menuItemId The ID of the context menu item to remove.
- * @param callback Called when the context menu has been removed.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function remove(menuItemId: number, callback?: () => void): void;
-
- /**
- * Since Chrome 21.
- * Fired when a context menu item is clicked.
- */
- var onClicked: MenuClickedEvent;
-}
-
-////////////////////
-// Cookies
-////////////////////
-/**
- * Use the chrome.cookies API to query and modify cookies, and to be notified
when they change.
- * Availability: Since Chrome 6.
- * Permissions: "cookies", host permissions
- */
-declare namespace chrome.cookies {
- /** Represents information about an HTTP cookie. */
- interface Cookie {
- /** The domain of the cookie (e.g. "www.google.com",
"example.com"). */
- domain: string;
- /** The name of the cookie. */
- name: string;
- /** The ID of the cookie store containing this cookie, as
provided in getAllCookieStores(). */
- storeId: string;
- /** The value of the cookie. */
- value: string;
- /** True if the cookie is a session cookie, as opposed to a
persistent cookie with an expiration date. */
- session: boolean;
- /** True if the cookie is a host-only cookie (i.e. a request's
host must exactly match the domain of the cookie). */
- hostOnly: boolean;
- /** Optional. The expiration date of the cookie as the number
of seconds since the UNIX epoch. Not provided for session cookies. */
- expirationDate?: number;
- /** The path of the cookie. */
- path: string;
- /** True if the cookie is marked as HttpOnly (i.e. the cookie
is inaccessible to client-side scripts). */
- httpOnly: boolean;
- /** True if the cookie is marked as Secure (i.e. its scope is
limited to secure channels, typically HTTPS). */
- secure: boolean;
- }
-
- /** Represents a cookie store in the browser. An incognito mode window,
for instance, uses a separate cookie store from a non-incognito window. */
- interface CookieStore {
- /** The unique identifier for the cookie store. */
- id: string;
- /** Identifiers of all the browser tabs that share this cookie
store. */
- tabIds: number[];
- }
-
- interface GetAllDetails {
- /** Optional. Restricts the retrieved cookies to those whose
domains match or are subdomains of this one. */
- domain?: string;
- /** Optional. Filters the cookies by name. */
- name?: string;
- /** Optional. Restricts the retrieved cookies to those that
would match the given URL. */
- url?: string;
- /** Optional. The cookie store to retrieve cookies from. If
omitted, the current execution context's cookie store will be used. */
- storeId?: string;
- /** Optional. Filters out session vs. persistent cookies. */
- session?: boolean;
- /** Optional. Restricts the retrieved cookies to those whose
path exactly matches this string. */
- path?: string;
- /** Optional. Filters the cookies by their Secure property. */
- secure?: boolean;
- }
-
- interface SetDetails {
- /** Optional. The domain of the cookie. If omitted, the cookie
becomes a host-only cookie. */
- domain?: string;
- /** Optional. The name of the cookie. Empty by default if
omitted. */
- name?: string;
- /** The request-URI to associate with the setting of the
cookie. This value can affect the default domain and path values of the created
cookie. If host permissions for this URL are not specified in the manifest
file, the API call will fail. */
- url: string;
- /** Optional. The ID of the cookie store in which to set the
cookie. By default, the cookie is set in the current execution context's cookie
store. */
- storeId?: string;
- /** Optional. The value of the cookie. Empty by default if
omitted. */
- value?: string;
- /** Optional. The expiration date of the cookie as the number
of seconds since the UNIX epoch. If omitted, the cookie becomes a session
cookie. */
- expirationDate?: number;
- /** Optional. The path of the cookie. Defaults to the path
portion of the url parameter. */
- path?: string;
- /** Optional. Whether the cookie should be marked as HttpOnly.
Defaults to false. */
- httpOnly?: boolean;
- /** Optional. Whether the cookie should be marked as Secure.
Defaults to false. */
- secure?: boolean;
- }
-
- interface Details {
- name: string;
- url: string;
- storeId?: string;
- }
-
- interface CookieChangeInfo {
- /** Information about the cookie that was set or removed. */
- cookie: Cookie;
- /** True if a cookie was removed. */
- removed: boolean;
- /**
- * Since Chrome 12.
- * The underlying reason behind the cookie's change.
- */
- cause: string;
- }
-
- interface CookieChangedEvent extends chrome.events.Event<(changeInfo:
CookieChangeInfo) => void> {}
-
- /**
- * Lists all existing cookie stores.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of CookieStore cookieStores) {...};
- * Parameter cookieStores: All the existing cookie stores.
- */
- export function getAllCookieStores(callback: (cookieStores: CookieStore[])
=> void): void;
- /**
- * Retrieves all cookies from a single cookie store that match the
given information. The cookies returned will be sorted, with those with the
longest path first. If multiple cookies have the same path length, those with
the earliest creation time will be first.
- * @param details Information to filter the cookies being retrieved.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of Cookie cookies) {...};
- * Parameter cookies: All the existing, unexpired cookies that match
the given cookie info.
- */
- export function getAll(details: GetAllDetails, callback: (cookies:
Cookie[]) => void): void;
- /**
- * Sets a cookie with the given cookie data; may overwrite equivalent
cookies if they exist.
- * @param details Details about the cookie being set.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function( Cookie cookie) {...};
- * Optional parameter cookie: Contains details about the cookie that's
been set. If setting failed for any reason, this will be "null", and
"chrome.runtime.lastError" will be set.
- */
- export function set(details: SetDetails, callback?: (cookie?: Cookie) =>
void): void;
- /**
- * Deletes a cookie by name.
- * @param details Information to identify the cookie to remove.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(object details) {...};
- */
- export function remove(details: Details, callback?: (details: Details) =>
void): void;
- /**
- * Retrieves information about a single cookie. If more than one cookie
of the same name exists for the given URL, the one with the longest path will
be returned. For cookies with the same path length, the cookie with the
earliest creation time will be returned.
- * @param details Details to identify the cookie being retrieved.
- * @param callback The callback parameter should be a function that
looks like this:
- * function( Cookie cookie) {...};
- * Parameter cookie: Contains details about the cookie. This parameter
is null if no such cookie was found.
- */
- export function get(details: Details, callback: (cookie?: Cookie) =>
void): void;
-
- /** Fired when a cookie is set or removed. As a special case, note that
updating a cookie's properties is implemented as a two step process: the cookie
to be updated is first removed entirely, generating a notification with "cause"
of "overwrite" . Afterwards, a new cookie is written with the updated values,
generating a second notification with "cause" "explicit". */
- var onChanged: CookieChangedEvent;
-}
-
-////////////////////
-// Debugger
-////////////////////
-/**
- * The chrome.debugger API serves as an alternate transport for Chrome's
remote debugging protocol. Use chrome.debugger to attach to one or more tabs to
instrument network interaction, debug JavaScript, mutate the DOM and CSS, etc.
Use the Debuggee tabId to target tabs with sendCommand and route events by
tabId from onEvent callbacks.
- * Availability: Since Chrome 18.
- * Permissions: "debugger"
- */
-declare module "chrome.debugger" {
- /** Debuggee identifier. Either tabId or extensionId must be specified
*/
- interface Debuggee {
- /** Optional. The id of the tab which you intend to debug. */
- tabId?: number;
- /**
- * Optional.
- * Since Chrome 27.
- * The id of the extension which you intend to debug. Attaching
to an extension background page is only possible when
'silent-debugger-extension-api' flag is enabled on the target browser.
- */
- extensionId?: string;
- /**
- * Optional.
- * Since Chrome 28.
- * The opaque id of the debug target.
- */
- targetId?: string;
- }
-
- /**
- * Since Chrome 28.
- * Debug target information
- */
- interface TargetInfo {
- /** Target type. */
- type: string;
- /** Target id. */
- id: string;
- /**
- * Optional.
- * Since Chrome 30.
- * The tab id, defined if type == 'page'.
- */
- tabId?: number;
- /**
- * Optional.
- * Since Chrome 30.
- * The extension id, defined if type = 'background_page'.
- */
- extensionId?: string;
- /** True if debugger is already attached. */
- attached: boolean;
- /** Target page title. */
- title: string;
- /** Target URL. */
- url: string;
- /** Optional. Target favicon URL. */
- faviconUrl?: string;
- }
-
- interface DebuggerDetachedEvent extends chrome.events.Event<(source:
Debuggee, reason: string) => void> {}
-
- interface DebuggerEventEvent extends chrome.events.Event<(source:
Debuggee, method: string, params?: Object) => void> {}
-
- /**
- * Attaches debugger to the given target.
- * @param target Debugging target to which you want to attach.
- * @param requiredVersion Required debugging protocol version ("0.1").
One can only attach to the debuggee with matching major version and greater or
equal minor version. List of the protocol versions can be obtained in the
documentation pages.
- * @param callback Called once the attach operation succeeds or fails.
Callback receives no arguments. If the attach fails, runtime.lastError will be
set to the error message.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function attach(target: Debuggee, requiredVersion: string,
callback?: () => void): void;
- /**
- * Detaches debugger from the given target.
- * @param target Debugging target from which you want to detach.
- * @param callback Called once the detach operation succeeds or fails.
Callback receives no arguments. If the detach fails, runtime.lastError will be
set to the error message.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function detach(target: Debuggee, callback?: () => void): void;
- /**
- * Sends given command to the debugging target.
- * @param target Debugging target to which you want to send the command.
- * @param method Method name. Should be one of the methods defined by
the remote debugging protocol.
- * @param commandParams Since Chrome 22.
- * JSON object with request parameters. This object must conform to the
remote debugging params scheme for given method.
- * @param callback Response body. If an error occurs while posting the
message, the callback will be called with no arguments and runtime.lastError
will be set to the error message.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(object result) {...};
- */
- export function sendCommand(target: Debuggee, method: string,
commandParams?: Object, callback?: (result?: Object) => void): void;
- /**
- * Since Chrome 28.
- * Returns the list of available debug targets.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of TargetInfo result) {...};
- * Parameter result: Array of TargetInfo objects corresponding to the
available debug targets.
- */
- export function getTargets(callback: (result: TargetInfo[]) => void):
void;
-
- /** Fired when browser terminates debugging session for the tab. This
happens when either the tab is being closed or Chrome DevTools is being invoked
for the attached tab. */
- var onDetach: DebuggerDetachedEvent;
- /** Fired whenever debugging target issues instrumentation event. */
- var onEvent: DebuggerEventEvent;
-}
-
-////////////////////
-// Declarative Content
-////////////////////
-/**
- * Use the chrome.declarativeContent API to take actions depending on the
content of a page, without requiring permission to read the page's content.
- * Availability: Since Chrome 33.
- * Permissions: "declarativeContent"
- */
-declare namespace chrome.declarativeContent {
- interface PageStateUrlDetails {
- /** Optional. Matches if the host name of the URL contains a
specified string. To test whether a host name component has a prefix 'foo', use
hostContains: '.foo'. This matches 'www.foobar.com' and 'foo.com', because an
implicit dot is added at the beginning of the host name. Similarly,
hostContains can be used to match against component suffix ('foo.') and to
exactly match against components ('.foo.'). Suffix- and exact-matching for the
last components need to be done separately using [...]
- hostContains?: string;
- /** Optional. Matches if the host name of the URL is equal to a
specified string. */
- hostEquals?: string;
- /** Optional. Matches if the host name of the URL starts with a
specified string. */
- hostPrefix?: string;
- /** Optional. Matches if the host name of the URL ends with a
specified string. */
- hostSuffix?: string;
- /** Optional. Matches if the path segment of the URL contains a
specified string. */
- pathContains?: string;
- /** Optional. Matches if the path segment of the URL is equal
to a specified string. */
- pathEquals?: string;
- /** Optional. Matches if the path segment of the URL starts
with a specified string. */
- pathPrefix?: string;
- /** Optional. Matches if the path segment of the URL ends with
a specified string. */
- pathSuffix?: string;
- /** Optional. Matches if the query segment of the URL contains
a specified string. */
- queryContains?: string;
- /** Optional. Matches if the query segment of the URL is equal
to a specified string. */
- queryEquals?: string;
- /** Optional. Matches if the query segment of the URL starts
with a specified string. */
- queryPrefix?: string;
- /** Optional. Matches if the query segment of the URL ends with
a specified string. */
- querySuffix?: string;
- /** Optional. Matches if the URL (without fragment identifier)
contains a specified string. Port numbers are stripped from the URL if they
match the default port number. */
- urlContains?: string;
- /** Optional. Matches if the URL (without fragment identifier)
is equal to a specified string. Port numbers are stripped from the URL if they
match the default port number. */
- urlEquals?: string;
- /** Optional. Matches if the URL (without fragment identifier)
matches a specified regular expression. Port numbers are stripped from the URL
if they match the default port number. The regular expressions use the RE2
syntax. */
- urlMatches?: string;
- /** Optional. Matches if the URL without query segment and
fragment identifier matches a specified regular expression. Port numbers are
stripped from the URL if they match the default port number. The regular
expressions use the RE2 syntax. */
- originAndPathMatches?: string;
- /** Optional. Matches if the URL (without fragment identifier)
starts with a specified string. Port numbers are stripped from the URL if they
match the default port number. */
- urlPrefix?: string;
- /** Optional. Matches if the URL (without fragment identifier)
ends with a specified string. Port numbers are stripped from the URL if they
match the default port number. */
- urlSuffix?: string;
- /** Optional. Matches if the scheme of the URL is equal to any
of the schemes specified in the array. */
- schemes?: string[];
- /** Optional. Matches if the port of the URL is contained in
any of the specified port lists. For example [80, 443, [1000, 1200]] matches
all requests on port 80, 443 and in the range 1000-1200. */
- ports?: (number | number[])[];
- }
-
- /** Matches the state of a web page by various criteria. */
- interface PageStateMatcher {
- /** Optional. Filters URLs for various criteria. See event
filtering. All criteria are case sensitive. */
- pageUrl?: PageStateUrlDetails;
- /** Optional. Matches if all of the CSS selectors in the array
match displayed elements in a frame with the same origin as the page's main
frame. All selectors in this array must be compound selectors to speed up
matching. Note that listing hundreds of CSS selectors or CSS selectors that
match hundreds of times per page can still slow down web sites. */
- css?: string[];
- /**
- * Optional.
- * Since Chrome 45. Warning: this is the current Beta channel.
More information available on the API documentation pages.
- * Matches if the bookmarked state of the page is equal to the
specified value. Requres the bookmarks permission.
- */
- isBookmarked?: boolean;
- }
-}
-
-////////////////////
-// Declarative Web Request
-////////////////////
-declare namespace chrome.declarativeWebRequest {
- interface HeaderFilter {
- nameEquals?: string;
- valueContains?: any;
- nameSuffix?: string;
- valueSuffix?: string;
- valuePrefix?: string;
- nameContains?: any;
- valueEquals?: string;
- namePrefix?: string;
- }
-
- interface AddResponseHeader {
- name: string;
- value: string;
- }
-
- interface RemoveResponseCookie {
- filter: ResponseCookie;
- }
-
- interface RemoveResponseHeader {
- name: string;
- value?: string;
- }
-
- interface RequestMatcher {
- contentType?: string[];
- url?: chrome.events.UrlFilter;
- excludeContentType?: string[];
- excludeResponseHeader?: HeaderFilter[];
- resourceType?: string;
- responseHeaders?: HeaderFilter[];
- }
-
- interface IgnoreRules {
- lowerPriorityThan: number;
- }
-
- interface RedirectToEmptyDocument { }
-
- interface RedirectRequest {
- redirectUrl: string;
- }
-
- interface ResponseCookie {
- domain?: string;
- name?: string;
- expires?: string;
- maxAge?: number;
- value?: string;
- path?: string;
- httpOnly?: string;
- secure?: string;
- }
-
- interface AddResponseCookie {
- cookie: ResponseCookie;
- }
-
- interface EditResponseCookie {
- filter: ResponseCookie;
- modification: ResponseCookie;
- }
-
- interface CancelRequest { }
-
- interface RemoveRequestHeader {
- name: string;
- }
-
- interface EditRequestCookie {
- filter: RequestCookie;
- modification: RequestCookie;
- }
-
- interface SetRequestHeader {
- name: string;
- value: string;
- }
-
- interface RequestCookie {
- name?: string;
- value?: string;
- }
-
- interface RedirectByRegEx {
- to: string;
- from: string;
- }
-
- interface RedirectToTransparentImage { }
-
- interface AddRequestCookie {
- cookie: RequestCookie;
- }
-
- interface RemoveRequestCookie {
- filter: RequestCookie;
- }
-
- interface RequestedEvent extends chrome.events.Event<Function> {}
-
- var onRequest: RequestedEvent;
-}
-
-////////////////////
-// DesktopCapture
-////////////////////
-/**
- * Desktop Capture API that can be used to capture content of screen,
individual windows or tabs.
- * Availability: Since Chrome 34.
- * Permissions: "desktopCapture"
- */
-declare namespace chrome.desktopCapture {
- /**
- * Shows desktop media picker UI with the specified set of sources.
- * @param sources Set of sources that should be shown to the user.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(string streamId) {...};
- * Parameter streamId: An opaque string that can be passed to
getUserMedia() API to generate media stream that corresponds to the source
selected by the user. If user didn't select any source (i.e. canceled the
prompt) then the callback is called with an empty streamId. The created
streamId can be used only once and expires after a few seconds when it is not
used.
- */
- export function chooseDesktopMedia(sources: string[], callback: (streamId:
string) => void): number;
- /**
- * Shows desktop media picker UI with the specified set of sources.
- * @param sources Set of sources that should be shown to the user.
- * @param targetTab Optional tab for which the stream is created. If
not specified then the resulting stream can be used only by the calling
extension. The stream can only be used by frames in the given tab whose
security origin matches tab.url.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(string streamId) {...};
- * Parameter streamId: An opaque string that can be passed to
getUserMedia() API to generate media stream that corresponds to the source
selected by the user. If user didn't select any source (i.e. canceled the
prompt) then the callback is called with an empty streamId. The created
streamId can be used only once and expires after a few seconds when it is not
used.
- */
- export function chooseDesktopMedia(sources: string[], targetTab:
chrome.tabs.Tab, callback: (streamId: string) => void): number;
- /**
- * Hides desktop media picker dialog shown by chooseDesktopMedia().
- * @param desktopMediaRequestId Id returned by chooseDesktopMedia()
- */
- export function cancelChooseDesktopMedia(desktopMediaRequestId: number):
void;
-}
-
-////////////////////
-// Dev Tools - Inspected Window
-////////////////////
-/**
- * Use the chrome.devtools.inspectedWindow API to interact with the inspected
window: obtain the tab ID for the inspected page, evaluate the code in the
context of the inspected window, reload the page, or obtain the list of
resources within the page.
- * Availability: Since Chrome 18.
- */
-declare namespace chrome.devtools.inspectedWindow {
- /** A resource within the inspected page, such as a document, a script,
or an image. */
- interface Resource {
- /** The URL of the resource. */
- url: string;
- /**
- * Gets the content of the resource.
- * @param callback A function that receives resource content
when the request completes.
- * The callback parameter should be a function that looks like
this:
- * function(string content, string encoding) {...};
- * Parameter content: Content of the resource (potentially
encoded).
- * Parameter encoding: Empty if content is not encoded,
encoding name otherwise. Currently, only base64 is supported.
- */
- getContent(callback: (content: string, encoding: string) => void):
void;
- /**
- * Sets the content of the resource.
- * @param content New content of the resource. Only resources
with the text type are currently supported.
- * @param commit True if the user has finished editing the
resource, and the new content of the resource should be persisted; false if
this is a minor change sent in progress of the user editing the resource.
- * @param callback A function called upon request completion.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function(object error) {...};
- * Optional parameter error: Set to undefined if the resource
content was set successfully; describes error otherwise.
- */
- setContent(content: string, commit: boolean, callback?: (error:
Object) => void): void;
- }
-
- interface ReloadOptions {
- /** Optional. If specified, the string will override the value
of the User-Agent HTTP header that's sent while loading the resources of the
inspected page. The string will also override the value of the
navigator.userAgent property that's returned to any scripts that are running
within the inspected page. */
- userAgent?: string;
- /** Optional. When true, the loader will ignore the cache for
all inspected page resources loaded before the load event is fired. The effect
is similar to pressing Ctrl+Shift+R in the inspected window or within the
Developer Tools window. */
- ignoreCache?: boolean;
- /** Optional. If specified, the script will be injected into
every frame of the inspected page immediately upon load, before any of the
frame's scripts. The script will not be injected after subsequent reloads—for
example, if the user presses Ctrl+R. */
- injectedScript?: boolean;
- /**
- * Optional.
- * If specified, this script evaluates into a function that
accepts three string arguments: the source to preprocess, the URL of the
source, and a function name if the source is an DOM event handler. The
preprocessorerScript function should return a string to be compiled by Chrome
in place of the input source. In the case that the source is a DOM event
handler, the returned source must compile to a single JS function.
- * @deprecated Deprecated since Chrome 41. Please avoid using
this parameter, it will be removed soon.
- */
- preprocessorScript?: string;
- }
-
- interface EvaluationExceptionInfo {
- /** Set if the error occurred on the DevTools side before the
expression is evaluated. */
- isError: boolean;
- /** Set if the error occurred on the DevTools side before the
expression is evaluated. */
- code: string;
- /** Set if the error occurred on the DevTools side before the
expression is evaluated. */
- description: string;
- /** Set if the error occurred on the DevTools side before the
expression is evaluated, contains the array of the values that may be
substituted into the description string to provide more information about the
cause of the error. */
- details: any[];
- /** Set if the evaluated code produces an unhandled exception.
*/
- isException: boolean;
- /** Set if the evaluated code produces an unhandled exception.
*/
- value: string;
- }
-
- interface ResourceAddedEvent extends chrome.events.Event<(resource:
Resource) => void> {}
-
- interface ResourceContentCommittedEvent extends
chrome.events.Event<(resource: Resource, content: string) => void> {}
-
- /** The ID of the tab being inspected. This ID may be used with
chrome.tabs.* API. */
- var tabId: number;
-
- /** Reloads the inspected page. */
- export function reload(reloadOptions: ReloadOptions): void;
- /**
- * Evaluates a JavaScript expression in the context of the main frame
of the inspected page. The expression must evaluate to a JSON-compliant object,
otherwise an exception is thrown. The eval function can report either a
DevTools-side error or a JavaScript exception that occurs during evaluation. In
either case, the result parameter of the callback is undefined. In the case of
a DevTools-side error, the isException parameter is non-null and has isError
set to true and code set to an er [...]
- * @param expression An expression to evaluate.
- * @param callback A function called when evaluation completes.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(object result, object exceptionInfo) {...};
- * Parameter result: The result of evaluation.
- * Parameter exceptionInfo: An object providing details if an exception
occurred while evaluating the expression.
- */
- export function eval(expression: string, callback?: (result: Object,
exceptionInfo: EvaluationExceptionInfo) => void): void;
- /**
- * Retrieves the list of resources from the inspected page.
- * @param callback A function that receives the list of resources when
the request completes.
- * The callback parameter should be a function that looks like this:
- * function(array of Resource resources) {...};
- */
- export function getResources(callback: (resources: Resource[]) => void):
void;
-
- /** Fired when a new resource is added to the inspected page. */
- var onResourceAdded: ResourceAddedEvent;
- /** Fired when a new revision of the resource is committed (e.g. user
saves an edited version of the resource in the Developer Tools). */
- var onResourceContentCommitted: ResourceContentCommittedEvent;
-}
-
-////////////////////
-// Dev Tools - Network
-////////////////////
-/**
- * Use the chrome.devtools.network API to retrieve the information about
network requests displayed by the Developer Tools in the Network panel.
- * Availability: Since Chrome 18.
- */
-declare namespace chrome.devtools.network {
- /** Represents a network request for a document resource (script, image
and so on). See HAR Specification for reference. */
- interface Request {
- /**
- * Returns content of the response body.
- * @param callback A function that receives the response body
when the request completes.
- * The callback parameter should be a function that looks like
this:
- * function(string content, string encoding) {...};
- * Parameter content: Content of the response body (potentially
encoded).
- * Parameter encoding: Empty if content is not encoded,
encoding name otherwise. Currently, only base64 is supported.
- */
- getContent(callback: (content: string, encoding: string) => void):
void;
- }
-
- interface RequestFinishedEvent extends chrome.events.Event<(request:
Request) => void> {}
-
- interface NavigatedEvent extends chrome.events.Event<(url: string) =>
void> {}
-
- /**
- * Returns HAR log that contains all known network requests.
- * @param callback A function that receives the HAR log when the
request completes.
- * The callback parameter should be a function that looks like this:
- * function(object harLog) {...};
- * Parameter harLog: A HAR log. See HAR specification for details.
- */
- export function getHAR(callback: (harLog: Object) => void): void;
-
- /** Fired when a network request is finished and all request data are
available. */
- var onRequestFinished: RequestFinishedEvent;
- /** Fired when the inspected window navigates to a new page. */
- var onNavigated: NavigatedEvent;
-}
-
-////////////////////
-// Dev Tools - Panels
-////////////////////
-/**
- * Use the chrome.devtools.panels API to integrate your extension into
Developer Tools window UI: create your own panels, access existing panels, and
add sidebars.
- * Availability: Since Chrome 18.
- */
-declare namespace chrome.devtools.panels {
- interface PanelShownEvent extends chrome.events.Event<(window:
chrome.windows.Window) => void> {}
-
- interface PanelHiddenEvent extends chrome.events.Event<() => void> {}
-
- interface PanelSearchEvent extends chrome.events.Event<(action: string,
queryString?: string) => void> {}
-
- /** Represents a panel created by extension. */
- interface ExtensionPanel {
- /**
- * Appends a button to the status bar of the panel.
- * @param iconPath Path to the icon of the button. The file
should contain a 64x24-pixel image composed of two 32x24 icons. The left icon
is used when the button is inactive; the right icon is displayed when the
button is pressed.
- * @param tooltipText Text shown as a tooltip when user hovers
the mouse over the button.
- * @param disabled Whether the button is disabled.
- */
- createStatusBarButton(iconPath: string, tooltipText: string, disabled:
boolean): Button;
- /** Fired when the user switches to the panel. */
- onShown: PanelShownEvent;
- /** Fired when the user switches away from the panel. */
- onHidden: PanelHiddenEvent;
- /** Fired upon a search action (start of a new search, search
result navigation, or search being canceled). */
- onSearch: PanelSearchEvent;
- }
-
- interface ButtonClickedEvent extends chrome.events.Event<() => void> {}
-
- /** A button created by the extension. */
- interface Button {
- /**
- * Updates the attributes of the button. If some of the
arguments are omitted or null, the corresponding attributes are not updated.
- * @param iconPath Path to the new icon of the button.
- * @param tooltipText Text shown as a tooltip when user hovers
the mouse over the button.
- * @param disabled Whether the button is disabled.
- */
- update(iconPath?: string, tooltipText?: string, disabled?: boolean):
void;
- /** Fired when the button is clicked. */
- onClicked: ButtonClickedEvent;
- }
-
- interface SelectionChangedEvent extends chrome.events.Event<() => void> {}
-
- /** Represents the Elements panel. */
- interface ElementsPanel {
- /**
- * Creates a pane within panel's sidebar.
- * @param title Text that is displayed in sidebar caption.
- * @param callback A callback invoked when the sidebar is
created.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function( ExtensionSidebarPane result) {...};
- * Parameter result: An ExtensionSidebarPane object for created
sidebar pane.
- */
- createSidebarPane(title: string, callback?: (result:
ExtensionSidebarPane) => void): void;
- /** Fired when an object is selected in the panel. */
- onSelectionChanged: SelectionChangedEvent;
- }
-
- /**
- * Since Chrome 41.
- * Represents the Sources panel.
- */
- interface SourcesPanel {
- /**
- * Creates a pane within panel's sidebar.
- * @param title Text that is displayed in sidebar caption.
- * @param callback A callback invoked when the sidebar is
created.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function( ExtensionSidebarPane result) {...};
- * Parameter result: An ExtensionSidebarPane object for created
sidebar pane.
- */
- createSidebarPane(title: string, callback?: (result:
ExtensionSidebarPane) => void): void;
- /** Fired when an object is selected in the panel. */
- onSelectionChanged: SelectionChangedEvent;
- }
-
- interface ExtensionSidebarPaneShownEvent extends
chrome.events.Event<(window: chrome.windows.Window) => void> {}
-
- interface ExtensionSidebarPaneHiddenEvent extends chrome.events.Event<()
=> void> {}
-
- /** A sidebar created by the extension. */
- interface ExtensionSidebarPane {
- /**
- * Sets the height of the sidebar.
- * @param height A CSS-like size specification, such as '100px'
or '12ex'.
- */
- setHeight(height: string): void;
- /**
- * Sets an expression that is evaluated within the inspected
page. The result is displayed in the sidebar pane.
- * @param expression An expression to be evaluated in context
of the inspected page. JavaScript objects and DOM nodes are displayed in an
expandable tree similar to the console/watch.
- * @param rootTitle An optional title for the root of the
expression tree.
- * @param callback A callback invoked after the sidebar pane is
updated with the expression evaluation results.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function() {...};
- */
- setExpression(expression: string, rootTitle?: string, callback?: () =>
void): void;
- /**
- * Sets an expression that is evaluated within the inspected
page. The result is displayed in the sidebar pane.
- * @param expression An expression to be evaluated in context
of the inspected page. JavaScript objects and DOM nodes are displayed in an
expandable tree similar to the console/watch.
- * @param callback A callback invoked after the sidebar pane is
updated with the expression evaluation results.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function() {...};
- */
- setExpression(expression: string, callback?: () => void): void;
- /**
- * Sets a JSON-compliant object to be displayed in the sidebar
pane.
- * @param jsonObject An object to be displayed in context of
the inspected page. Evaluated in the context of the caller (API client).
- * @param rootTitle An optional title for the root of the
expression tree.
- * @param callback A callback invoked after the sidebar is
updated with the object.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function() {...};
- */
- setObject(jsonObject: string, rootTitle?: string, callback?: () =>
void): void;
- /**
- * Sets a JSON-compliant object to be displayed in the sidebar
pane.
- * @param jsonObject An object to be displayed in context of
the inspected page. Evaluated in the context of the caller (API client).
- * @param callback A callback invoked after the sidebar is
updated with the object.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function() {...};
- */
- setObject(jsonObject: string, callback?: () => void): void;
- /**
- * Sets an HTML page to be displayed in the sidebar pane.
- * @param path Relative path of an extension page to display
within the sidebar.
- */
- setPage(path: string): void;
- /** Fired when the sidebar pane becomes visible as a result of
user switching to the panel that hosts it. */
- onShown: ExtensionSidebarPaneShownEvent;
- /** Fired when the sidebar pane becomes hidden as a result of
the user switching away from the panel that hosts the sidebar pane. */
- onHidden: ExtensionSidebarPaneHiddenEvent;
- }
-
- /** Elements panel. */
- var elements: ElementsPanel;
- /**
- * Since Chrome 38.
- * Sources panel.
- */
- var sources: SourcesPanel;
-
- /**
- * Creates an extension panel.
- * @param title Title that is displayed next to the extension icon in
the Developer Tools toolbar.
- * @param iconPath Path of the panel's icon relative to the extension
directory.
- * @param pagePath Path of the panel's HTML page relative to the
extension directory.
- * @param callback A function that is called when the panel is created.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function( ExtensionPanel panel) {...};
- * Parameter panel: An ExtensionPanel object representing the created
panel.
- */
- export function create(title: string, iconPath: string, pagePath: string,
callback?: (panel: ExtensionPanel) => void): void;
- /**
- * Specifies the function to be called when the user clicks a resource
link in the Developer Tools window. To unset the handler, either call the
method with no parameters or pass null as the parameter.
- * @param callback A function that is called when the user clicks on a
valid resource link in Developer Tools window. Note that if the user clicks an
invalid URL or an XHR, this function is not called.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function( devtools.inspectedWindow.Resource resource) {...};
- * Parameter resource: A devtools.inspectedWindow.Resource object for
the resource that was clicked.
- */
- export function setOpenResourceHandler(callback?: (resource:
chrome.devtools.inspectedWindow.Resource) => void): void;
- /**
- * Since Chrome 38.
- * Requests DevTools to open a URL in a Developer Tools panel.
- * @param url The URL of the resource to open.
- * @param lineNumber Specifies the line number to scroll to when the
resource is loaded.
- * @param callback A function that is called when the resource has been
successfully loaded.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function openResource(url: string, lineNumber: number, callback:
() => void): void;
-}
-
-////////////////////
-// Document Scan
-////////////////////
-/**
- * Use the chrome.documentScan API to discover and retrieve images from
attached paper document scanners.
- * Availability: Since Chrome 44.
- * Permissions: "documentScan"
- * Important: This API works only on Chrome OS.
- */
-declare namespace chrome.documentScan {
- interface DocumentScanOptions {
- /** Optional. The MIME types that are accepted by the caller.
*/
- mimeTypes?: string[];
- /** Optional. The number of scanned images allowed (defaults to
1). */
- maxImages?: number;
- }
-
- interface DocumentScanCallbackArg {
- /** The data image URLs in a form that can be passed as the
"src" value to an image tag. */
- dataUrls: string[];
- /** The MIME type of dataUrls. */
- mimeType: string;
- }
-
- /**
- * Performs a document scan. On success, the PNG data will be sent to
the callback.
- * @param options Object containing scan parameters.
- * @param callback Called with the result and data from the scan.
- * The callback parameter should be a function that looks like this:
- * function(object result) {...};
- */
- export function scan(options: DocumentScanOptions, callback: (result:
DocumentScanCallbackArg) => void): void;
-}
-
-////////////////////
-// Dev Tools - Downloads
-////////////////////
-/**
- * Use the chrome.downloads API to programmatically initiate, monitor,
manipulate, and search for downloads.
- * Availability: Since Chrome 31.
- * Permissions: "downloads"
- */
-declare namespace chrome.downloads {
- interface HeaderNameValuePair {
- /** Name of the HTTP header. */
- name: string;
- /** Value of the HTTP header. */
- value: string;
- }
-
- interface DownloadOptions {
- /** Optional. Post body. */
- body?: string;
- /** Optional. Use a file-chooser to allow the user to select a
filename regardless of whether filename is set or already exists. */
- saveAs?: boolean;
- /** The URL to download. */
- url: string;
- /** Optional. A file path relative to the Downloads directory
to contain the downloaded file, possibly containing subdirectories. Absolute
paths, empty paths, and paths containing back-references ".." will cause an
error. onDeterminingFilename allows suggesting a filename after the file's MIME
type and a tentative filename have been determined. */
- filename?: string;
- /** Optional. Extra HTTP headers to send with the request if
the URL uses the HTTP[s] protocol. Each header is represented as a dictionary
containing the keys name and either value or binaryValue, restricted to those
allowed by XMLHttpRequest. */
- headers?: HeaderNameValuePair[];
- /** Optional. The HTTP method to use if the URL uses the
HTTP[S] protocol. */
- method?: string;
- /** Optional. The action to take if filename already exists. */
- conflictAction?: string;
- }
-
- interface DownloadDelta {
- /** Optional. The change in danger, if any. */
- danger?: StringDelta;
- /** Optional. The change in url, if any. */
- url?: StringDelta;
- /** Optional. The change in totalBytes, if any. */
- totalBytes?: DoubleDelta;
- /** Optional. The change in filename, if any. */
- filename?: StringDelta;
- /** Optional. The change in paused, if any. */
- paused?: BooleanDelta;
- /** Optional. The change in state, if any. */
- state?: StringDelta;
- /** Optional. The change in mime, if any. */
- mime?: StringDelta;
- /** Optional. The change in fileSize, if any. */
- fileSize?: DoubleDelta;
- /** Optional. The change in startTime, if any. */
- startTime?: DoubleDelta;
- /** Optional. The change in error, if any. */
- error?: StringDelta;
- /** Optional. The change in endTime, if any. */
- endTime?: DoubleDelta;
- /** The id of the DownloadItem that changed. */
- id: number;
- /** Optional. The change in canResume, if any. */
- canResume?: BooleanDelta;
- /** Optional. The change in exists, if any. */
- exists?: BooleanDelta;
- }
-
- interface BooleanDelta {
- current?: boolean;
- previous?: boolean;
- }
-
- /** Since Chrome 34. */
- interface DoubleDelta {
- current?: number;
- previous?: number;
- }
-
- interface StringDelta {
- current?: string;
- previous?: string;
- }
-
- interface DownloadItem {
- /** Number of bytes received so far from the host, without
considering file compression. */
- bytesReceived: number;
- /** Indication of whether this download is thought to be safe
or known to be suspicious. */
- danger: string;
- /** Absolute URL. */
- url: string;
- /** Number of bytes in the whole file, without considering file
compression, or -1 if unknown. */
- totalBytes: number;
- /** Absolute local path. */
- filename: string;
- /** True if the download has stopped reading data from the
host, but kept the connection open. */
- paused: boolean;
- /** Indicates whether the download is progressing, interrupted,
or complete. */
- state: string;
- /** The file's MIME type. */
- mime: string;
- /** Number of bytes in the whole file post-decompression, or -1
if unknown. */
- fileSize: number;
- /** The time when the download began in ISO 8601 format. May be
passed directly to the Date constructor: chrome.downloads.search({},
function(items){items.forEach(function(item){console.log(new
Date(item.startTime))})}) */
- startTime: string;
- /** Optional. Why the download was interrupted. Several kinds
of HTTP errors may be grouped under one of the errors beginning with SERVER_.
Errors relating to the network begin with NETWORK_, errors relating to the
process of writing the file to the file system begin with FILE_, and
interruptions initiated by the user begin with USER_. */
- error?: string;
- /** Optional. The time when the download ended in ISO 8601
format. May be passed directly to the Date constructor:
chrome.downloads.search({}, function(items){items.forEach(function(item){if
(item.endTime) console.log(new Date(item.endTime))})}) */
- endTime?: string;
- /** An identifier that is persistent across browser sessions. */
- id: number;
- /** False if this download is recorded in the history, true if
it is not recorded. */
- incognito: boolean;
- /** Absolute URL. */
- referrer: string;
- /** Optional. Estimated time when the download will complete in
ISO 8601 format. May be passed directly to the Date constructor:
chrome.downloads.search({}, function(items){items.forEach(function(item){if
(item.estimatedEndTime) console.log(new Date(item.estimatedEndTime))})}) */
- estimatedEndTime?: string;
- /** True if the download is in progress and paused, or else if
it is interrupted and can be resumed starting from where it was interrupted. */
- canResume: boolean;
- /** Whether the downloaded file still exists. This information
may be out of date because Chrome does not automatically watch for file
removal. Call search() in order to trigger the check for file existence. When
the existence check completes, if the file has been deleted, then an onChanged
event will fire. Note that search() does not wait for the existence check to
finish before returning, so results from search() may not accurately reflect
the file system. Also, search() may be calle [...]
- exists: boolean;
- /** Optional. The identifier for the extension that initiated
this download if this download was initiated by an extension. Does not change
once it is set. */
- byExtensionId?: string;
- /** Optional. The localized name of the extension that
initiated this download if this download was initiated by an extension. May
change if the extension changes its name or if the user changes their locale.
*/
- byExtensionName?: string;
- }
-
- interface GetFileIconOptions {
- /** Optional. * The size of the returned icon. The icon will be
square with dimensions size * size pixels. The default and largest size for the
icon is 32x32 pixels. The only supported sizes are 16 and 32. It is an error to
specify any other size.
- */
- size?: number;
- }
-
- interface DownloadQuery {
- /** Optional. Set elements of this array to DownloadItem
properties in order to sort search results. For example, setting
orderBy=['startTime'] sorts the DownloadItem by their start time in ascending
order. To specify descending order, prefix with a hyphen: '-startTime'. */
- orderBy?: string[];
- /** Optional. Limits results to DownloadItem whose url matches
the given regular expression. */
- urlRegex?: string;
- /** Optional. Limits results to DownloadItem that ended before
the given ms since the epoch. */
- endedBefore?: number;
- /** Optional. Limits results to DownloadItem whose totalBytes
is greater than the given integer. */
- totalBytesGreater?: number;
- /** Optional. Indication of whether this download is thought to
be safe or known to be suspicious. */
- danger?: string;
- /** Optional. Number of bytes in the whole file, without
considering file compression, or -1 if unknown. */
- totalBytes?: number;
- /** Optional. True if the download has stopped reading data
from the host, but kept the connection open. */
- paused?: boolean;
- /** Optional. Limits results to DownloadItem whose filename
matches the given regular expression. */
- filenameRegex?: string;
- /** Optional. This array of search terms limits results to
DownloadItem whose filename or url contain all of the search terms that do not
begin with a dash '-' and none of the search terms that do begin with a dash.
*/
- query?: string[];
- /** Optional. Limits results to DownloadItem whose totalBytes
is less than the given integer. */
- totalBytesLess?: number;
- /** Optional. The id of the DownloadItem to query. */
- id?: number;
- /** Optional. Number of bytes received so far from the host,
without considering file compression. */
- bytesReceived?: number;
- /** Optional. Limits results to DownloadItem that ended after
the given ms since the epoch. */
- endedAfter?: number;
- /** Optional. Absolute local path. */
- filename?: string;
- /** Optional. Indicates whether the download is progressing,
interrupted, or complete. */
- state?: string;
- /** Optional. Limits results to DownloadItem that started after
the given ms since the epoch. */
- startedAfter?: number;
- /** Optional. The file's MIME type. */
- mime?: string;
- /** Optional. Number of bytes in the whole file
post-decompression, or -1 if unknown. */
- fileSize?: number;
- /** Optional. The time when the download began in ISO 8601
format. */
- startTime?: number;
- /** Optional. Absolute URL. */
- url?: string;
- /** Optional. Limits results to DownloadItem that started
before the given ms since the epoch. */
- startedBefore?: number;
- /** Optional. The maximum number of matching DownloadItem
returned. Defaults to 1000. Set to 0 in order to return all matching
DownloadItem. See search for how to page through results. */
- limit?: number;
- /** Optional. Why a download was interrupted. */
- error?: number;
- /** Optional. The time when the download ended in ISO 8601
format. */
- endTime?: number;
- /** Optional. Whether the downloaded file exists; */
- exists?: boolean;
- }
-
- interface DownloadFilenameSuggestion {
- /** The DownloadItem's new target DownloadItem.filename, as a
path relative to the user's default Downloads directory, possibly containing
subdirectories. Absolute paths, empty paths, and paths containing
back-references ".." will be ignored. */
- filename: string;
- /** Optional. The action to take if filename already exists. */
- conflictAction?: string;
- }
-
- interface DownloadChangedEvent extends chrome.events.Event<(downloadDelta:
DownloadDelta) => void> {}
-
- interface DownloadCreatedEvent extends chrome.events.Event<(downloadItem:
DownloadItem) => void> {}
-
- interface DownloadErasedEvent extends chrome.events.Event<(downloadId:
number) => void> {}
-
- interface DownloadDeterminingFilenameEvent extends
chrome.events.Event<(downloadItem: DownloadItem, suggest: (suggestion?:
DownloadFilenameSuggestion) => void) => void> {}
-
- /**
- * Find DownloadItem. Set query to the empty object to get all
DownloadItem. To get a specific DownloadItem, set only the id field. To page
through a large number of items, set orderBy: ['-startTime'], set limit to the
number of items per page, and set startedAfter to the startTime of the last
item from the last page.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of DownloadItem results) {...};
- */
- export function search(query: DownloadQuery, callback: (results:
DownloadItem[]) => void): void;
- /**
- * Pause the download. If the request was successful the download is in
a paused state. Otherwise runtime.lastError contains an error message. The
request will fail if the download is not active.
- * @param downloadId The id of the download to pause.
- * @param callback Called when the pause request is completed.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function pause(downloadId: number, callback?: () => void): void;
- /**
- * Retrieve an icon for the specified download. For new downloads, file
icons are available after the onCreated event has been received. The image
returned by this function while a download is in progress may be different from
the image returned after the download is complete. Icon retrieval is done by
querying the underlying operating system or toolkit depending on the platform.
The icon that is returned will therefore depend on a number of factors
including state of the download, plat [...]
- * @param downloadId The identifier for the download.
- * @param callback A URL to an image that represents the download.
- * The callback parameter should be a function that looks like this:
- * function(string iconURL) {...};
- */
- export function getFileIcon(downloadId: number, callback: (iconURL:
string) => void): void;
- /**
- * Retrieve an icon for the specified download. For new downloads, file
icons are available after the onCreated event has been received. The image
returned by this function while a download is in progress may be different from
the image returned after the download is complete. Icon retrieval is done by
querying the underlying operating system or toolkit depending on the platform.
The icon that is returned will therefore depend on a number of factors
including state of the download, plat [...]
- * @param downloadId The identifier for the download.
- * @param callback A URL to an image that represents the download.
- * The callback parameter should be a function that looks like this:
- * function(string iconURL) {...};
- */
- export function getFileIcon(downloadId: number, options:
GetFileIconOptions, callback: (iconURL: string) => void): void;
- /**
- * Resume a paused download. If the request was successful the download
is in progress and unpaused. Otherwise runtime.lastError contains an error
message. The request will fail if the download is not active.
- * @param downloadId The id of the download to resume.
- * @param callback Called when the resume request is completed.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function resume(downloadId: number, callback?: () => void): void;
- /**
- * Cancel a download. When callback is run, the download is cancelled,
completed, interrupted or doesn't exist anymore.
- * @param downloadId The id of the download to cancel.
- * @param callback Called when the cancel request is completed.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function cancel(downloadId: number, callback?: () => void): void;
- /**
- * Download a URL. If the URL uses the HTTP[S] protocol, then the
request will include all cookies currently set for its hostname. If both
filename and saveAs are specified, then the Save As dialog will be displayed,
pre-populated with the specified filename. If the download started
successfully, callback will be called with the new DownloadItem's downloadId.
If there was an error starting the download, then callback will be called with
downloadId=undefined and runtime.lastError will co [...]
- * @param options What to download and how.
- * @param callback Called with the id of the new DownloadItem.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(integer downloadId) {...};
- */
- export function download(options: DownloadOptions, callback?: (downloadId:
number) => void): void;
- /**
- * Open the downloaded file now if the DownloadItem is complete;
otherwise returns an error through runtime.lastError. Requires the
"downloads.open" permission in addition to the "downloads" permission. An
onChanged event will fire when the item is opened for the first time.
- * @param downloadId The identifier for the downloaded file.
- */
- export function open(downloadId: number): void;
- /**
- * Show the downloaded file in its folder in a file manager.
- * @param downloadId The identifier for the downloaded file.
- */
- export function show(downloadId: number): void;
- /** Show the default Downloads folder in a file manager. */
- export function showDefaultFolder(): void;
- /**
- * Erase matching DownloadItem from history without deleting the
downloaded file. An onErased event will fire for each DownloadItem that matches
query, then callback will be called.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(array of integer erasedIds) {...};
- */
- export function erase(query: DownloadQuery, callback: (erasedIds:
number[]) => void): void;
- /**
- * Remove the downloaded file if it exists and the DownloadItem is
complete; otherwise return an error through runtime.lastError.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function removeFile(downloadId: number, callback?: () => void):
void;
- /**
- * Prompt the user to accept a dangerous download. Can only be called
from a visible context (tab, window, or page/browser action popup). Does not
automatically accept dangerous downloads. If the download is accepted, then an
onChanged event will fire, otherwise nothing will happen. When all the data is
fetched into a temporary file and either the download is not dangerous or the
danger has been accepted, then the temporary file is renamed to the target
filename, the |state| changes to [...]
- * @param downloadId The identifier for the DownloadItem.
- * @param callback Called when the danger prompt dialog closes.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function acceptDanger(downloadId: number, callback: () => void):
void;
- /** Initiate dragging the downloaded file to another application. Call
in a javascript ondragstart handler. */
- export function drag(downloadId: number): void;
- /** Enable or disable the gray shelf at the bottom of every window
associated with the current browser profile. The shelf will be disabled as long
as at least one extension has disabled it. Enabling the shelf while at least
one other extension has disabled it will return an error through
runtime.lastError. Requires the "downloads.shelf" permission in addition to the
"downloads" permission. */
- export function setShelfEnabled(enabled: boolean): void;
-
- /** When any of a DownloadItem's properties except bytesReceived and
estimatedEndTime changes, this event fires with the downloadId and an object
containing the properties that changed. */
- var onChanged: DownloadChangedEvent;
- /** This event fires with the DownloadItem object when a download
begins. */
- var onCreated: DownloadCreatedEvent;
- /** Fires with the downloadId when a download is erased from history. */
- var onErased: DownloadErasedEvent;
- /** During the filename determination process, extensions will be given
the opportunity to override the target DownloadItem.filename. Each extension
may not register more than one listener for this event. Each listener must call
suggest exactly once, either synchronously or asynchronously. If the listener
calls suggest asynchronously, then it must return true. If the listener neither
calls suggest synchronously nor returns true, then suggest will be called
automatically. The DownloadIte [...]
- var onDeterminingFilename: DownloadDeterminingFilenameEvent;
-}
-
-////////////////////
-// Enterprise Platform Keys
-////////////////////
-/**
- * Use the chrome.enterprise.platformKeys API to generate hardware-backed keys
and to install certificates for these keys. The certificates will be managed by
the platform and can be used for TLS authentication, network access or by other
extension through chrome.platformKeys.
- * Availability: Since Chrome 37.
- * Permissions: "enterprise.platformKeys"
- * Important: This API works only on Chrome OS.
- * Note: This API is only for extensions pre-installed by policy.
- */
-declare namespace chrome.enterprise.platformKeys {
- interface Token {
- /**
- * Uniquely identifies this Token.
- * Static IDs are "user" and "system", referring to the
platform's user-specific and the system-wide hardware token, respectively. Any
other tokens (with other identifiers) might be returned by
enterprise.platformKeys.getTokens.
- */
- id: string;
- /**
- * Implements the WebCrypto's SubtleCrypto interface. The
cryptographic operations, including key generation, are hardware-backed.
- * Only non-extractable RSASSA-PKCS1-V1_5 keys with
modulusLength up to 2048 can be generated. Each key can be used for signing
data at most once.
- * Keys generated on a specific Token cannot be used with any
other Tokens, nor can they be used with window.crypto.subtle. Equally, Key
objects created with window.crypto.subtle cannot be used with this interface.
- */
- subtleCrypto: SubtleCrypto;
- }
-
- /**
- * Returns the available Tokens. In a regular user's session the list
will always contain the user's token with id "user". If a system-wide TPM token
is available, the returned list will also contain the system-wide token with id
"system". The system-wide token will be the same for all sessions on this
device (device in the sense of e.g. a Chromebook).
- * @param callback Invoked by getTokens with the list of available
Tokens.
- * The callback parameter should be a function that looks like this:
- * function(array of Token tokens) {...};
- * Parameter tokens: The list of available tokens.
- */
- export function getToken(callback: (tokens: Token[]) => void): void;
- /**
- * Returns the list of all client certificates available from the given
token. Can be used to check for the existence and expiration of client
certificates that are usable for a certain authentication.
- * @param tokenId The id of a Token returned by getTokens.
- * @param callback Called back with the list of the available
certificates.
- * The callback parameter should be a function that looks like this:
- * function(array of ArrayBuffer certificates) {...};
- * Parameter certificates: The list of certificates, each in DER
encoding of a X.509 certificate.
- */
- export function getCertificates(tokenId: string, callback:
(certificates: ArrayBuffer) => void): void;
- /**
- * Imports certificate to the given token if the certified key is
already stored in this token. After a successful certification request, this
function should be used to store the obtained certificate and to make it
available to the operating system and browser for authentication.
- * @param tokenId The id of a Token returned by getTokens.
- * @param certificate The DER encoding of a X.509 certificate.
- * @param callback Called back when this operation is finished.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function importCertificate(tokenId: string, certificate:
ArrayBuffer, callback?: () => void): void;
- /**
- * Removes certificate from the given token if present. Should be used
to remove obsolete certificates so that they are not considered during
authentication and do not clutter the certificate choice. Should be used to
free storage in the certificate store.
- * @param tokenId The id of a Token returned by getTokens.
- * @param certificate The DER encoding of a X.509 certificate.
- * @param callback Called back when this operation is finished.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeCertificate(tokenId: string, certificate:
ArrayBuffer, callback?: () => void): void;
-}
-
-////////////////////
-// Events
-////////////////////
-/**
- * The chrome.events namespace contains common types used by APIs dispatching
events to notify you when something interesting happens.
- * Availability: Since Chrome 21.
- */
-declare namespace chrome.events {
- /** Filters URLs for various criteria. See event filtering. All
criteria are case sensitive. */
- interface UrlFilter {
- /** Optional. Matches if the scheme of the URL is equal to any
of the schemes specified in the array. */
- schemes?: string[];
- /**
- * Optional.
- * Since Chrome 23.
- * Matches if the URL (without fragment identifier) matches a
specified regular expression. Port numbers are stripped from the URL if they
match the default port number. The regular expressions use the RE2 syntax.
- */
- urlMatches?: string;
- /** Optional. Matches if the path segment of the URL contains a
specified string. */
- pathContains?: string;
- /** Optional. Matches if the host name of the URL ends with a
specified string. */
- hostSuffix?: string;
- /** Optional. Matches if the host name of the URL starts with a
specified string. */
- hostPrefix?: string;
- /** Optional. Matches if the host name of the URL contains a
specified string. To test whether a host name component has a prefix 'foo', use
hostContains: '.foo'. This matches 'www.foobar.com' and 'foo.com', because an
implicit dot is added at the beginning of the host name. Similarly,
hostContains can be used to match against component suffix ('foo.') and to
exactly match against components ('.foo.'). Suffix- and exact-matching for the
last components need to be done separately using [...]
- hostContains?: string;
- /** Optional. Matches if the URL (without fragment identifier)
contains a specified string. Port numbers are stripped from the URL if they
match the default port number. */
- urlContains?: string;
- /** Optional. Matches if the query segment of the URL ends with
a specified string. */
- querySuffix?: string;
- /** Optional. Matches if the URL (without fragment identifier)
starts with a specified string. Port numbers are stripped from the URL if they
match the default port number. */
- urlPrefix?: string;
- /** Optional. Matches if the host name of the URL is equal to a
specified string. */
- hostEquals?: string;
- /** Optional. Matches if the URL (without fragment identifier)
is equal to a specified string. Port numbers are stripped from the URL if they
match the default port number. */
- urlEquals?: string;
- /** Optional. Matches if the query segment of the URL contains
a specified string. */
- queryContains?: string;
- /** Optional. Matches if the path segment of the URL starts
with a specified string. */
- pathPrefix?: string;
- /** Optional. Matches if the path segment of the URL is equal
to a specified string. */
- pathEquals?: string;
- /** Optional. Matches if the path segment of the URL ends with
a specified string. */
- pathSuffix?: string;
- /** Optional. Matches if the query segment of the URL is equal
to a specified string. */
- queryEquals?: string;
- /** Optional. Matches if the query segment of the URL starts
with a specified string. */
- queryPrefix?: string;
- /** Optional. Matches if the URL (without fragment identifier)
ends with a specified string. Port numbers are stripped from the URL if they
match the default port number. */
- urlSuffix?: string;
- /** Optional. Matches if the port of the URL is contained in
any of the specified port lists. For example [80, 443, [1000, 1200]] matches
all requests on port 80, 443 and in the range 1000-1200. */
- ports?: any[];
- /**
- * Optional.
- * Since Chrome 28.
- * Matches if the URL without query segment and fragment
identifier matches a specified regular expression. Port numbers are stripped
from the URL if they match the default port number. The regular expressions use
the RE2 syntax.
- */
- originAndPathMatches?: string;
- }
-
- /** An object which allows the addition and removal of listeners for a
Chrome event. */
- interface Event<T extends Function> {
- /**
- * Registers an event listener callback to an event.
- * @param callback Called when an event occurs. The parameters
of this function depend on the type of event.
- * The callback parameter should be a function that looks like
this:
- * function() {...};
- */
- addListener(callback: T): void;
- /**
- * Returns currently registered rules.
- * @param callback Called with registered rules.
- * The callback parameter should be a function that looks like
this:
- * function(array of Rule rules) {...};
- * Parameter rules: Rules that were registered, the optional
parameters are filled with values.
- */
- getRules(callback: (rules: Rule[]) => void): void;
- /**
- * Returns currently registered rules.
- * @param ruleIdentifiers If an array is passed, only rules
with identifiers contained in this array are returned.
- * @param callback Called with registered rules.
- * The callback parameter should be a function that looks like
this:
- * function(array of Rule rules) {...};
- * Parameter rules: Rules that were registered, the optional
parameters are filled with values.
- */
- getRules(ruleIdentifiers: string[], callback: (rules: Rule[]) =>
void): void;
- /**
- * @param callback Listener whose registration status shall be
tested.
- */
- hasListener(callback: T): boolean;
- /**
- * Unregisters currently registered rules.
- * @param ruleIdentifiers If an array is passed, only rules
with identifiers contained in this array are unregistered.
- * @param callback Called when rules were unregistered.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function() {...};
- */
- removeRules(ruleIdentifiers?: string[], callback?: () => void): void;
- /**
- * Unregisters currently registered rules.
- * @param callback Called when rules were unregistered.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function() {...};
- */
- removeRules(callback?: () => void): void;
- /**
- * Registers rules to handle events.
- * @param rules Rules to be registered. These do not replace
previously registered rules.
- * @param callback Called with registered rules.
- * If you specify the callback parameter, it should be a
function that looks like this:
- * function(array of Rule rules) {...};
- * Parameter rules: Rules that were registered, the optional
parameters are filled with values.
- */
- addRules(rules: Rule[], callback?: (rules: Rule[]) => void): void;
- /**
- * Deregisters an event listener callback from an event.
- * @param callback Listener that shall be unregistered.
- * The callback parameter should be a function that looks like
this:
- * function() {...};
- */
- removeListener(callback: T): void;
- hasListeners(): boolean;
- }
-
- /** Description of a declarative rule for handling events. */
- interface Rule {
- /** Optional. Optional priority of this rule. Defaults to 100.
*/
- priority?: number;
- /** List of conditions that can trigger the actions. */
- conditions: any[];
- /** Optional. Optional identifier that allows referencing this
rule. */
- id?: string;
- /** List of actions that are triggered if one of the condtions
is fulfilled. */
- actions: any[];
- /**
- * Optional.
- * Since Chrome 28.
- * Tags can be used to annotate rules and perform operations on
sets of rules.
- */
- tags?: string[];
- }
-}
-
-////////////////////
-// Extension
-////////////////////
-/**
- * The chrome.extension API has utilities that can be used by any extension
page. It includes support for exchanging messages between an extension and its
content scripts or between extensions, as described in detail in Message
Passing.
- * Availability: Since Chrome 5.
- */
-declare namespace chrome.extension {
- interface FetchProperties {
- /** Optional. The window to restrict the search to. If omitted,
returns all views. */
- windowId?: number;
- /** Optional. The type of view to get. If omitted, returns all
views (including background pages and tabs). Valid values: 'tab',
'notification', 'popup'. */
- type?: string;
- }
-
- interface LastError {
- /** Description of the error that has taken place. */
- message: string;
- }
-
- interface OnRequestEvent extends chrome.events.Event<((request: any,
sender: runtime.MessageSender, sendResponse: (response: any) => void) => void)
| ((sender: runtime.MessageSender, sendResponse: (response: any) => void) =>
void)> {}
-
- /**
- * Since Chrome 7.
- * True for content scripts running inside incognito tabs, and for
extension pages running inside an incognito process. The latter only applies to
extensions with 'split' incognito_behavior.
- */
- var inIncognitoContext: boolean;
- /** Set for the lifetime of a callback if an ansychronous extension api
has resulted in an error. If no error has occured lastError will be undefined.
*/
- var lastError: LastError;
-
- /** Returns the JavaScript 'window' object for the background page
running inside the current extension. Returns null if the extension has no
background page. */
- export function getBackgroundPage(): Window;
- /**
- * Converts a relative path within an extension install directory to a
fully-qualified URL.
- * @param path A path to a resource within an extension expressed
relative to its install directory.
- */
- export function getURL(path: string): string;
- /**
- * Sets the value of the ap CGI parameter used in the extension's
update URL. This value is ignored for extensions that are hosted in the Chrome
Extension Gallery.
- * Since Chrome 9.
- */
- export function setUpdateUrlData(data: string): void;
- /** Returns an array of the JavaScript 'window' objects for each of the
pages running inside the current extension. */
- export function getViews(fetchProperties?: FetchProperties): Window[];
- /**
- * Retrieves the state of the extension's access to the 'file://'
scheme (as determined by the user-controlled 'Allow access to File URLs'
checkbox.
- * Since Chrome 12.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(boolean isAllowedAccess) {...};
- * Parameter isAllowedAccess: True if the extension can access the
'file://' scheme, false otherwise.
- */
- export function isAllowedFileSchemeAccess(callback: (isAllowedAccess:
boolean) => void): void;
- /**
- * Retrieves the state of the extension's access to Incognito-mode (as
determined by the user-controlled 'Allowed in Incognito' checkbox.
- * Since Chrome 12.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(boolean isAllowedAccess) {...};
- * Parameter isAllowedAccess: True if the extension has access to
Incognito mode, false otherwise.
- */
- export function isAllowedIncognitoAccess(callback: (isAllowedAccess:
boolean) => void): void;
- /**
- * Sends a single request to other listeners within the extension.
Similar to runtime.connect, but only sends a single request with an optional
response. The extension.onRequest event is fired in each page of the extension.
- * @deprecated Deprecated since Chrome 33. Please use
runtime.sendMessage.
- * @param extensionId The extension ID of the extension you want to
connect to. If omitted, default is your own extension.
- * @param responseCallback If you specify the responseCallback
parameter, it should be a function that looks like this:
- * function(any response) {...};
- * Parameter response: The JSON response object sent by the handler of
the request. If an error occurs while connecting to the extension, the callback
will be called with no arguments and runtime.lastError will be set to the error
message.
- */
- export function sendRequest(extensionId: string, request: any,
responseCallback?: (response: any) => void): void;
- /**
- * Sends a single request to other listeners within the extension.
Similar to runtime.connect, but only sends a single request with an optional
response. The extension.onRequest event is fired in each page of the extension.
- * @deprecated Deprecated since Chrome 33. Please use
runtime.sendMessage.
- * @param responseCallback If you specify the responseCallback
parameter, it should be a function that looks like this:
- * function(any response) {...};
- * Parameter response: The JSON response object sent by the handler of
the request. If an error occurs while connecting to the extension, the callback
will be called with no arguments and runtime.lastError will be set to the error
message.
- */
- export function sendRequest(request: any, responseCallback?: (response:
any) => void): void;
- /**
- * Returns an array of the JavaScript 'window' objects for each of the
tabs running inside the current extension. If windowId is specified, returns
only the 'window' objects of tabs attached to the specified window.
- * @deprecated Deprecated since Chrome 33. Please use
extension.getViews {type: "tab"}.
- */
- export function getExtensionTabs(windowId?: number): Window[];
-
- /**
- * Fired when a request is sent from either an extension process or a
content script.
- * @deprecated Deprecated since Chrome 33. Please use runtime.onMessage.
- */
- var onRequest: OnRequestEvent;
- /**
- * Fired when a request is sent from another extension.
- * @deprecated Deprecated since Chrome 33. Please use
runtime.onMessageExternal.
- */
- var onRequestExternal: OnRequestEvent;
-}
-
-////////////////////
-// File Browser Handler
-////////////////////
-/**
- * Use the chrome.fileBrowserHandler API to extend the Chrome OS file browser.
For example, you can use this API to enable users to upload files to your
website.
- * Availability: Since Chrome 12.
- * Permissions: "fileBrowserHandler"
- * Important: This API works only on Chrome OS.
- */
-declare namespace chrome.fileBrowserHandler {
- interface SelectionParams {
- /**
- * Optional.
- * List of file extensions that the selected file can have. The
list is also used to specify what files to be shown in the select file dialog.
Files with the listed extensions are only shown in the dialog. Extensions
should not include the leading '.'. Example: ['jpg', 'png']
- * Since Chrome 23.
- */
- allowedFileExtensions?: string[];
- /** Suggested name for the file. */
- suggestedName: string;
- }
-
- interface SelectionResult {
- /** Optional. Selected file entry. It will be null if a file
hasn't been selected. */
- entry?: Object;
- /** Whether the file has been selected. */
- success: boolean;
- }
-
- /** Event details payload for fileBrowserHandler.onExecute event. */
- interface FileHandlerExecuteEventDetails {
- /** Optional. The ID of the tab that raised this event. Tab IDs
are unique within a browser session. */
- tab_id?: number;
- /** Array of Entry instances representing files that are
targets of this action (selected in ChromeOS file browser). */
- entries: any[];
- }
-
- interface FileBrowserHandlerExecuteEvent extends chrome.events.Event<(id:
string, details: FileHandlerExecuteEventDetails) => void> {}
-
- /**
- * Prompts user to select file path under which file should be saved.
When the file is selected, file access permission required to use the file
(read, write and create) are granted to the caller. The file will not actually
get created during the function call, so function caller must ensure its
existence before using it. The function has to be invoked with a user gesture.
- * Since Chrome 21.
- * @param selectionParams Parameters that will be used while selecting
the file.
- * @param callback Function called upon completion.
- * The callback parameter should be a function that looks like this:
- * function(object result) {...};
- * Parameter result: Result of the method.
- */
- export function selectFile(selectionParams: SelectionParams, callback:
(result: SelectionResult) => void): void;
-
- /** Fired when file system action is executed from ChromeOS file
browser. */
- var onExecute: FileBrowserHandlerExecuteEvent;
-}
-
-////////////////////
-// File System Provider
-////////////////////
-/**
- * Use the chrome.fileSystemProvider API to create file systems, that can be
accessible from the file manager on Chrome OS.
- * Availability: Since Chrome 40.
- * Permissions: "fileSystemProvider"
- * Important: This API works only on Chrome OS.
- */
-declare namespace chrome.fileSystemProvider {
- interface OpenedFileInfo {
- /** A request ID to be be used by consecutive read/write and
close requests. */
- openRequestId: number;
- /** The path of the opened file. */
- filePath: string;
- /** Whether the file was opened for reading or writing. */
- mode: string;
- }
-
- interface FileWatchersInfo {
- /** The path of the entry being observed. */
- entryPath: string;
- /** Whether watching should include all child entries
recursively. It can be true for directories only. */
- recursive: boolean;
- /** Optional. Tag used by the last notification for the
watcher. */
- lastTag?: string;
- }
-
- interface EntryMetadata {
- /** True if it is a directory. */
- isDirectory: boolean;
- /** Name of this entry (not full path name). Must not contain
'/'. For root it must be empty. */
- name: string;
- /** File size in bytes. */
- size: number;
- /** The last modified time of this entry. */
- modificationTime: Date;
- /** Optional. Mime type for the entry. */
- mimeType?: string;
- /** Optional. Thumbnail image as a data URI in either PNG, JPEG
or WEBP format, at most 32 KB in size. Optional, but can be provided only when
explicitly requested by the onGetMetadataRequested event. */
- thumbnail?: string;
- }
-
- interface FileSystemInfo {
- /** The identifier of the file system. */
- fileSystemId: string;
- /** A human-readable name for the file system. */
- displayName: string;
- /** Whether the file system supports operations which may
change contents of the file system (such as creating, deleting or writing to
files). */
- writable: boolean;
- /**
- * The maximum number of files that can be opened at once. If
0, then not limited.
- * @since Since Chrome 42.
- */
- openedFilesLimit: number;
- /**
- * List of currently opened files.
- * @since Since Chrome 42.
- */
- openedFiles: OpenedFileInfo[];
- /**
- * Optional.
- * Whether the file system supports the tag field for observing
directories.
- * @since Since Chrome 45. Warning: this is the current Beta
channel.
- */
- supportsNotifyTag?: boolean;
- /**
- * List of watchers.
- * @since Since Chrome 45. Warning: this is the current Beta
channel.
- */
- watchers: FileWatchersInfo[];
- }
-
- /** @since Since Chrome 45. Warning: this is the current Beta channel.
*/
- interface GetActionsRequestedOptions {
- /** The identifier of the file system related to this
operation. */
- fileSystemId: string;
- /** The unique identifier of this request. */
- requestId: number;
- /** The path of the entry to return the list of actions for. */
- entryPath: string;
- }
-
- /** @since Since Chrome 45. Warning: this is the current Beta channel.
*/
- interface Action {
- /** The identifier of the action. Any string or CommonActionId
for common actions. */
- id: string;
- /** Optional. The title of the action. It may be ignored for
common actions. */
- title?: string;
- }
-
- /** @since Since Chrome 45. Warning: this is the current Beta channel.
*/
- interface ExecuteActionRequestedOptions {
- /** The identifier of the file system related to this
operation. */
- fileSystemId: string;
- /** The unique identifier of this request. */
- requestId: number;
- /** The path of the entry to be used for the action. */
- entryPath: string;
- /** The identifier of the action to be executed. */
- actionId: string;
- }
-
- interface MountOptions {
- /** The string indentifier of the file system. Must be unique
per each extension. */
- fileSystemId: string;
- /** A human-readable name for the file system. */
- displayName: string;
- /** Optional. Whether the file system supports operations which
may change contents of the file system (such as creating, deleting or writing
to files). */
- writable?: boolean;
- /**
- * Optional.
- * The maximum number of files that can be opened at once. If
not specified, or 0, then not limited.
- * @since Since Chrome 41.
- */
- openedFilesLimit?: number;
- /**
- * Optional.
- * Whether the file system supports the tag field for observed
directories.
- * @since Since Chrome 45. Warning: this is the current Beta
channel.
- */
- supportsNotifyTag?: boolean;
- }
-
- interface UnmountOptions {
- /** The identifier of the file system to be unmounted. */
- fileSystemId: string;
- }
-
- interface NotificationChange {
- /** The path of the changed entry. */
- entryPath: string;
- /** The type of the change which happened to the entry. */
- changeType: string;
- }
-
- interface NotificationOptions {
- /** The identifier of the file system related to this change. */
- fileSystemId: string;
- /** The path of the observed entry. */
- observedPath: string;
- /** Mode of the observed entry. */
- recursive: boolean;
- /** The type of the change which happened to the observed
entry. If it is DELETED, then the observed entry will be automatically removed
from the list of observed entries. */
- changeType: string;
- /** Optional. List of changes to entries within the observed
directory (including the entry itself) */
- changes?: NotificationChange[];
- /** Optional. Tag for the notification. Required if the file
system was mounted with the supportsNotifyTag option. Note, that this flag is
necessary to provide notifications about changes which changed even when the
system was shutdown. */
- tag?: string;
- }
-
- interface RequestedEventOptions {
- /** The identifier of the file system related to this
operation. */
- fileSystemId: string;
- /** The unique identifier of this request. */
- requestId: number;
- }
-
- interface EntryPathRequestedEventOptions extends RequestedEventOptions {
- /** The path of the entry to which this operation is related
to. */
- entryPath: string;
- }
-
- interface MetadataRequestedEventOptions extends
EntryPathRequestedEventOptions {
- /** Set to true if the thumbnail is requested. */
- thumbnail: boolean;
- }
-
- interface DirectoryPathRequestedEventOptions extends
RequestedEventOptions {
- /** The path of the directory which is to be operated on. */
- directoryPath: string;
- }
-
- interface FilePathRequestedEventOptions extends RequestedEventOptions {
- /** The path of the entry for the operation */
- filePath: string;
- }
-
- interface OpenFileRequestedEventOptions extends
FilePathRequestedEventOptions {
- /** Whether the file will be used for reading or writing. */
- mode: string;
- }
-
- interface OpenedFileRequestedEventOptions extends RequestedEventOptions
{
- /** A request ID used to open the file. */
- openRequestId: number;
- }
-
- interface OpenedFileOffsetRequestedEventOptions extends
OpenedFileRequestedEventOptions {
- /** Position in the file (in bytes) to start reading from. */
- offset: number;
- /** Number of bytes to be returned. */
- length: number;
- }
-
- interface DirectoryPathRecursiveRequestedEventOptions extends
DirectoryPathRequestedEventOptions {
- /** Whether the operation is recursive (for directories only).
*/
- recursive: boolean;
- }
-
- interface EntryPathRecursiveRequestedEventOptions extends
EntryPathRequestedEventOptions {
- /** Whether the operation is recursive (for directories only).
*/
- recursive: boolean;
- }
-
- interface SourceTargetPathRequestedEventOptions extends
RequestedEventOptions {
- /** The source path for the operation. */
- sourcePath: string;
- /** The destination path for the operation. */
- targetPath: string;
- }
-
- interface FilePathLengthRequestedEventOptions extends
FilePathRequestedEventOptions {
- /** Number of bytes to be retained after the operation
completes. */
- length: number;
- }
-
- interface OpenedFileIoRequestedEventOptions extends
OpenedFileRequestedEventOptions {
- /** Position in the file (in bytes) to start operating from. */
- offset: number;
- /** Buffer of bytes to be operated on the file. */
- data: ArrayBuffer;
- }
-
- interface OperationRequestedEventOptions extends RequestedEventOptions {
- /** An ID of the request to which this operation is related. */
- operationRequestId: number;
- }
-
- interface RequestedEvent extends chrome.events.Event<(options:
RequestedEventOptions, successCallback: Function, errorCallback: (error:
string) => void) => void> {}
-
- interface MetadataRequestedEvent extends chrome.events.Event<(options:
MetadataRequestedEventOptions, successCallback: (metadata: EntryMetadata) =>
void, errorCallback: (error: string) => void) => void> {}
-
- interface DirectoryPathRequestedEvent extends
chrome.events.Event<(options: DirectoryPathRequestedEventOptions,
successCallback: (entries: EntryMetadata[], hasMore: boolean) => void,
errorCallback: (error: string) => void) => void> {}
-
- interface OpenFileRequestedEvent extends chrome.events.Event<(options:
OpenFileRequestedEventOptions, successCallback: Function, errorCallback:
(error: string) => void) => void> {}
-
- interface OpenedFileRequestedEvent extends
chrome.events.Event<(options: OpenedFileRequestedEventOptions, successCallback:
Function, errorCallback: (error: string) => void) => void> {}
-
- interface OpenedFileOffsetRequestedEvent extends
chrome.events.Event<(options: OpenedFileOffsetRequestedEventOptions,
successCallback: (data: ArrayBuffer, hasMore: boolean) => void, errorCallback:
(error: string) => void) => void> {}
-
- interface DirectoryPathRecursiveRequestedEvent extends
chrome.events.Event<(options: DirectoryPathRecursiveRequestedEventOptions,
successCallback: Function, errorCallback: (error: string) => void) => void> {}
-
- interface EntryPathRecursiveRequestedEvent extends
chrome.events.Event<(options: EntryPathRecursiveRequestedEventOptions,
successCallback: Function, errorCallback: (error: string) => void) => void> {}
-
- interface FilePathRequestedEvent extends chrome.events.Event<(options:
FilePathRequestedEventOptions, successCallback: Function, errorCallback:
(error: string) => void) => void> {}
-
- interface SourceTargetPathRequestedEvent extends
chrome.events.Event<(options: SourceTargetPathRequestedEventOptions,
successCallback: Function, errorCallback: (error: string) => void) => void> {}
-
- interface FilePathLengthRequestedEvent extends
chrome.events.Event<(options: FilePathLengthRequestedEventOptions,
successCallback: Function, errorCallback: (error: string) => void) => void> {}
-
- interface OpenedFileIoRequestedEvent extends
chrome.events.Event<(options: OpenedFileIoRequestedEventOptions,
successCallback: Function, errorCallback: (error: string) => void) => void> {}
-
- interface OperationRequestedEvent extends chrome.events.Event<(options:
OperationRequestedEventOptions, successCallback: Function, errorCallback:
(error: string) => void) => void> {}
-
- interface OptionlessRequestedEvent extends
chrome.events.Event<(successCallback: Function, errorCallback: (error: string)
=> void) => void> {}
-
- /**
- * Mounts a file system with the given fileSystemId and displayName.
displayName will be shown in the left panel of Files.app. displayName can
contain any characters including '/', but cannot be an empty string.
displayName must be descriptive but doesn't have to be unique. The fileSystemId
must not be an empty string.
- * Depending on the type of the file system being mounted, the source
option must be set appropriately.
- * In case of an error, runtime.lastError will be set with a
corresponding error code.
- * @param callback A generic result callback to indicate success or
failure.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function mount(options: MountOptions, callback?: () => void):
void;
- /**
- * Unmounts a file system with the given fileSystemId. It must be
called after onUnmountRequested is invoked. Also, the providing extension can
decide to perform unmounting if not requested (eg. in case of lost connection,
or a file error).
- * In case of an error, runtime.lastError will be set with a
corresponding error code.
- * @param callback A generic result callback to indicate success or
failure.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function unmount(options: UnmountOptions, callback?: () =>
void): void;
- /**
- * Returns all file systems mounted by the extension.
- * @param callback Callback to receive the result of getAll function.
- * The callback parameter should be a function that looks like this:
- * function(array of FileSystemInfo fileSystems) {...};
- */
- export function getAll(callback: (fileSystems: FileSystemInfo[]) =>
void): void;
- /**
- * Returns information about a file system with the passed fileSystemId.
- * @since Since Chrome 42.
- * @param callback Callback to receive the result of get function.
- * The callback parameter should be a function that looks like this:
- * function(FileSystemInfo fileSystem) {...};
- */
- export function get(fileSystemId: string, callback: (fileSystem:
FileSystemInfo) => void): void;
- /**
- * Notifies about changes in the watched directory at observedPath in
recursive mode. If the file system is mounted with supportsNofityTag, then tag
must be provided, and all changes since the last notification always reported,
even if the system was shutdown. The last tag can be obtained with getAll.
- * To use, the file_system_provider.notify manifest option must be set
to true.
- * Value of tag can be any string which is unique per call, so it's
possible to identify the last registered notification. Eg. if the providing
extension starts after a reboot, and the last registered notification's tag is
equal to "123", then it should call notify for all changes which happened since
the change tagged as "123". It cannot be an empty string.
- * Not all providers are able to provide a tag, but if the file system
has a changelog, then the tag can be eg. a change number, or a revision number.
- * Note that if a parent directory is removed, then all descendant
entries are also removed, and if they are watched, then the API must be
notified about the fact. Also, if a directory is renamed, then all descendant
entries are in fact removed, as there is no entry under their original paths
anymore.
- * In case of an error, runtime.lastError will be set will a
corresponding error code.
- * @param callback A generic result callback to indicate success or
failure.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function notify(options: NotificationOptions, callback: () =>
void): void;
-
- /** Raised when unmounting for the file system with the fileSystemId
identifier is requested. In the response, the unmount API method must be called
together with successCallback. If unmounting is not possible (eg. due to a
pending operation), then errorCallback must be called. */
- var onUnmountRequested: RequestedEvent;
- /** Raised when metadata of a file or a directory at entryPath is
requested. The metadata must be returned with the successCallback call. In case
of an error, errorCallback must be called. */
- var onGetMetadataRequested: MetadataRequestedEvent;
- /** Raised when contents of a directory at directoryPath are requested.
The results must be returned in chunks by calling the successCallback several
times. In case of an error, errorCallback must be called. */
- var onReadDirectoryRequested: DirectoryPathRequestedEvent;
- /** Raised when opening a file at filePath is requested. If the file
does not exist, then the operation must fail. Maximum number of files opened at
once can be specified with MountOptions. */
- var onOpenFileRequested: OpenFileRequestedEvent;
- /** Raised when opening a file previously opened with openRequestId is
requested to be closed. */
- var onCloseFileRequested: OpenedFileRequestedEvent;
- /** Raised when reading contents of a file opened previously with
openRequestId is requested. The results must be returned in chunks by calling
successCallback several times. In case of an error, errorCallback must be
called. */
- var onReadFileRequested: OpenedFileOffsetRequestedEvent;
- /** Raised when creating a directory is requested. The operation must
fail with the EXISTS error if the target directory already exists. If recursive
is true, then all of the missing directories on the directory path must be
created. */
- var onCreateDirectoryRequested: DirectoryPathRecursiveRequestedEvent;
- /** Raised when deleting an entry is requested. If recursive is true,
and the entry is a directory, then all of the entries inside must be
recursively deleted as well. */
- var onDeleteEntryRequested: EntryPathRecursiveRequestedEvent;
- /** Raised when creating a file is requested. If the file already
exists, then errorCallback must be called with the "EXISTS" error code. */
- var onCreateFileRequested: FilePathRequestedEvent;
- /** Raised when copying an entry (recursively if a directory) is
requested. If an error occurs, then errorCallback must be called. */
- var onCopyEntryRequested: SourceTargetPathRequestedEvent;
- /** Raised when moving an entry (recursively if a directory) is
requested. If an error occurs, then errorCallback must be called. */
- var onMoveEntryRequested: SourceTargetPathRequestedEvent;
- /** Raised when truncating a file to a desired length is requested. If
an error occurs, then errorCallback must be called. */
- var onTruncateRequested: FilePathLengthRequestedEvent;
- /** Raised when writing contents to a file opened previously with
openRequestId is requested. */
- var onWriteFileRequested: OpenedFileIoRequestedEvent;
- /** Raised when aborting an operation with operationRequestId is
requested. The operation executed with operationRequestId must be immediately
stopped and successCallback of this abort request executed. If aborting fails,
then errorCallback must be called. Note, that callbacks of the aborted
operation must not be called, as they will be ignored. Despite calling
errorCallback, the request may be forcibly aborted. */
- var onAbortRequested: OperationRequestedEvent;
- /**
- * Raised when showing a configuration dialog for fileSystemId is
requested. If it's handled, the file_system_provider.configurable manfiest
option must be set to true.
- * @since Since Chrome 44.
- */
- var onConfigureRequested: RequestedEvent;
- /**
- * Raised when showing a dialog for mounting a new file system is
requested. If the extension/app is a file handler, then this event shouldn't be
handled. Instead app.runtime.onLaunched should be handled in order to mount new
file systems when a file is opened. For multiple mounts, the
file_system_provider.multiple_mounts manifest option must be set to true.
- * @since Since Chrome 44.
- */
- var onMountRequested: OptionlessRequestedEvent;
- /**
- * Raised when setting a new directory watcher is requested. If an
error occurs, then errorCallback must be called.
- * @since Since Chrome 45. Warning: this is the current Beta channel.
- */
- var onAddWatcherRequested: EntryPathRecursiveRequestedEvent;
- /**
- * Raised when the watcher should be removed. If an error occurs, then
errorCallback must be called.
- * @since Since Chrome 45. Warning: this is the current Beta channel.
- */
- var onRemoveWatcherRequested: EntryPathRecursiveRequestedEvent;
-}
-
-////////////////////
-// Font Settings
-////////////////////
-/**
- * Use the chrome.fontSettings API to manage Chrome's font settings.
- * Availability: Since Chrome 22.
- * Permissions: "fontSettings"
- */
-declare namespace chrome.fontSettings {
- /** Represents a font name. */
- interface FontName {
- /** The display name of the font. */
- displayName: string;
- /** The font ID. */
- fontId: string;
- }
-
- interface DefaultFontSizeDetails {
- /** The font size in pixels. */
- pixelSize: number;
- }
-
- interface FontDetails {
- /** The generic font family for the font. */
- genericFamily: string;
- /** Optional. The script for the font. If omitted, the global
script font setting is affected. */
- script?: string;
- }
-
- interface FullFontDetails {
- /** The generic font family for which the font setting has
changed. */
- genericFamily: string;
- /** The level of control this extension has over the setting. */
- levelOfControl: string;
- /** Optional. The script code for which the font setting has
changed. */
- script?: string;
- /** The font ID. See the description in getFont. */
- fontId: string;
- }
-
- interface FontDetailsResult {
- /** The level of control this extension has over the setting. */
- levelOfControl: string;
- /** The font ID. Rather than the literal font ID preference
value, this may be the ID of the font that the system resolves the preference
value to. So, fontId can differ from the font passed to setFont, if, for
example, the font is not available on the system. The empty string signifies
fallback to the global script font setting. */
- fontId: string;
- }
-
- interface FontSizeDetails {
- /** The font size in pixels. */
- pixelSize: number;
- /** The level of control this extension has over the setting. */
- levelOfControl: string;
- }
-
- interface SetFontSizeDetails {
- /** The font size in pixels. */
- pixelSize: number;
- }
-
- interface SetFontDetails extends FontDetails {
- /** The font ID. The empty string means to fallback to the
global script font setting. */
- fontId: string;
- }
-
- interface DefaultFixedFontSizeChangedEvent extends
chrome.events.Event<(details: FontSizeDetails) => void> {}
-
- interface DefaultFontSizeChangedEvent extends
chrome.events.Event<(details: FontSizeDetails) => void> {}
-
- interface MinimumFontSizeChangedEvent extends
chrome.events.Event<(details: FontSizeDetails) => void> {}
-
- interface FontChangedEvent extends chrome.events.Event<(details:
FullFontDetails) => void> {}
-
- /**
- * Sets the default font size.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function setDefaultFontSize(details: DefaultFontSizeDetails,
callback?: Function): void;
- /**
- * Gets the font for a given script and generic font family.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(object details) {...};
- */
- export function getFont(details: FontDetails, callback?: (details:
FontDetailsResult) => void): void;
- /**
- * Gets the default font size.
- * @param details This parameter is currently unused.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(object details) {...};
- */
- export function getDefaultFontSize(details?: Object, callback?:
(options: FontSizeDetails) => void): void;
- /**
- * Gets the minimum font size.
- * @param details This parameter is currently unused.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(object details) {...};
- */
- export function getMinimumFontSize(details?: FontSizeDetails, callback?:
(options: FontSizeDetails) => void): void;
- /**
- * Sets the minimum font size.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function setMinimumFontSize(details: SetFontSizeDetails, callback?:
Function): void;
- /**
- * Gets the default size for fixed width fonts.
- * @param details This parameter is currently unused.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(object details) {...};
- */
- export function getDefaultFixedFontSize(details?: Object, callback?:
(details: FontSizeDetails) => void): void;
- /**
- * Clears the default font size set by this extension, if any.
- * @param details This parameter is currently unused.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function clearDefaultFontSize(details?: Object, callback?:
Function): void;
- /**
- * Sets the default size for fixed width fonts.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function setDefaultFixedFontSize(details: SetFontSizeDetails,
callback?: Function): void;
- /**
- * Clears the font set by this extension, if any.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function clearFont(details: FontDetails, callback?: Function): void;
- /**
- * Sets the font for a given script and generic font family.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(object details) {...};
- */
- export function setFont(details: SetFontDetails, callback?: Function):
void;
- /**
- * Clears the minimum font size set by this extension, if any.
- * @param details This parameter is currently unused.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function clearMinimumFontSize(details?: Object, callback?:
Function): void;
- /**
- * Gets a list of fonts on the system.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of FontName results) {...};
- */
- export function getFontList(callback: (results: FontName[]) => void): void;
- /**
- * Clears the default fixed font size set by this extension, if any.
- * @param details This parameter is currently unused.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function clearDefaultFixedFontSize(details: Object, callback?:
Function): void;
-
- /** Fired when the default fixed font size setting changes. */
- var onDefaultFixedFontSizeChanged: DefaultFixedFontSizeChangedEvent;
- /** Fired when the default font size setting changes. */
- var onDefaultFontSizeChanged: DefaultFontSizeChangedEvent;
- /** Fired when the minimum font size setting changes. */
- var onMinimumFontSizeChanged: MinimumFontSizeChangedEvent;
- /** Fired when a font setting changes. */
- var onFontChanged: FontChangedEvent;
-}
-
-////////////////////
-// Google Cloud Messaging
-////////////////////
-/**
- * Use chrome.gcm to enable apps and extensions to send and receive messages
through the Google Cloud Messaging Service.
- * Availability: Since Chrome 35.
- * Permissions: "gcm"
- */
-declare namespace chrome.gcm {
- interface OutgoingMessage {
- /** The ID of the server to send the message to as assigned by
Google API Console. */
- destinationId: string;
- /** The ID of the message. It must be unique for each message
in scope of the applications. See the Cloud Messaging documentation for advice
for picking and handling an ID. */
- messageId: string;
- /** Optional. Time-to-live of the message in seconds. If it is
not possible to send the message within that time, an onSendError event will be
raised. A time-to-live of 0 indicates that the message should be sent
immediately or fail if it's not possible. The maximum and a default value of
time-to-live is 86400 seconds (1 day). */
- timeToLive?: number;
- /** Message data to send to the server. Case-insensitive goog.
and google, as well as case-sensitive collapse_key are disallowed as key
prefixes. Sum of all key/value pairs should not exceed gcm.MAX_MESSAGE_SIZE. */
- data: Object;
- }
-
- interface IncomingMessage {
- /** The message data. */
- data: Object;
- /**
- * Optional.
- * The sender who issued the message.
- * @since Since Chrome 41.
- */
- from?: string;
- /**
- * Optional.
- * The collapse key of a message. See Collapsible Messages
section of Cloud Messaging documentation for details.
- */
- collapseKey?: string;
- }
-
- interface GcmError {
- /** The error message describing the problem. */
- errorMessage: string;
- /** Optional. The ID of the message with this error, if error
is related to a specific message. */
- messageId?: string;
- /** Additional details related to the error, when available. */
- detail: Object;
- }
-
- interface MessageReceptionEvent extends chrome.events.Event<(message:
IncomingMessage) => void> {}
-
- interface MessageDeletionEvent extends chrome.events.Event<() => void>
{}
-
- interface GcmErrorEvent extends chrome.events.Event<(error: GcmError)
=> void> {}
-
- /** The maximum size (in bytes) of all key/value pairs in a message. */
- var MAX_MESSAGE_SIZE: number;
-
- /**
- * Registers the application with GCM. The registration ID will be
returned by the callback. If register is called again with the same list of
senderIds, the same registration ID will be returned.
- * @param senderIds A list of server IDs that are allowed to send
messages to the application. It should contain at least one and no more than
100 sender IDs.
- * @param callback Function called when registration completes. It
should check runtime.lastError for error when registrationId is empty.
- * The callback parameter should be a function that looks like this:
- * function(string registrationId) {...};
- * Parameter registrationId: A registration ID assigned to the
application by the GCM.
- */
- export function register(senderIds: string[], callback:
(registrationId: string) => void): void;
- /**
- * Unregisters the application from GCM.
- * @param callback A function called after the unregistration
completes. Unregistration was successful if runtime.lastError is not set.
- * The callback parameter should be a function that looks like this:
- * function() {...};
- */
- export function unregister(callback: () => void): void;
- /**
- * Sends a message according to its contents.
- * @param message A message to send to the other party via GCM.
- * @param callback A function called after the message is successfully
queued for sending. runtime.lastError should be checked, to ensure a message
was sent without problems.
- * The callback parameter should be a function that looks like this:
- * function(string messageId) {...};
- * Parameter messageId: The ID of the message that the callback was
issued for.
- */
- export function send(message: OutgoingMessage, callback: (messageId:
string) => void): void;
-
- /** Fired when a message is received through GCM. */
- var onMessage: MessageReceptionEvent;
- /** Fired when a GCM server had to delete messages sent by an app
server to the application. See Messages deleted event section of Cloud
Messaging documentation for details on handling this event. */
- var onMessagesDeleted: MessageDeletionEvent;
- /** Fired when it was not possible to send a message to the GCM server.
*/
- var onSendError: GcmErrorEvent;
-}
-
-////////////////////
-// History
-////////////////////
-/**
- * Use the chrome.history API to interact with the browser's record of visited
pages. You can add, remove, and query for URLs in the browser's history. To
override the history page with your own version, see Override Pages.
- * Availability: Since Chrome 5.
- * Permissions: "history"
- */
-declare namespace chrome.history {
- /** An object encapsulating one visit to a URL. */
- interface VisitItem {
- /** The transition type for this visit from its referrer. */
- transition: string;
- /** Optional. When this visit occurred, represented in
milliseconds since the epoch. */
- visitTime?: number;
- /** The unique identifier for this visit. */
- visitId: string;
- /** The visit ID of the referrer. */
- referringVisitId: string;
- /** The unique identifier for the item. */
- id: string;
- }
-
- /** An object encapsulating one result of a history query. */
- interface HistoryItem {
- /** Optional. The number of times the user has navigated to
this page by typing in the address. */
- typedCount?: number;
- /** Optional. The title of the page when it was last loaded. */
- title?: string;
- /** Optional. The URL navigated to by a user. */
- url?: string;
- /** Optional. When this page was last loaded, represented in
milliseconds since the epoch. */
- lastVisitTime?: number;
- /** Optional. The number of times the user has navigated to
this page. */
- visitCount?: number;
- /** The unique identifier for the item. */
- id: string;
- }
-
- interface HistoryQuery {
- /** A free-text query to the history service. Leave empty to
retrieve all pages. */
- text: string;
- /** Optional. The maximum number of results to retrieve.
Defaults to 100. */
- maxResults?: number;
- /** Optional. Limit results to those visited after this date,
represented in milliseconds since the epoch. */
- startTime?: number;
- /** Optional. Limit results to those visited before this date,
represented in milliseconds since the epoch. */
- endTime?: number;
- }
-
- interface Url {
- /** The URL for the operation. It must be in the format as
returned from a call to history.search. */
- url: string;
- }
-
- interface Range {
- /** Items added to history before this date, represented in
milliseconds since the epoch. */
- endTime: number;
- /** Items added to history after this date, represented in
milliseconds since the epoch. */
- startTime: number;
- }
-
- interface RemovedResult {
- /** True if all history was removed. If true, then urls will be
empty. */
- allHistory: boolean;
- /** Optional. */
- urls?: string[];
- }
-
- interface HistoryVisitedEvent extends chrome.events.Event<(result:
HistoryItem) => void> {}
-
- interface HistoryVisitRemovedEvent extends chrome.events.Event<(removed:
RemovedResult) => void> {}
-
- /**
- * Searches the history for the last visit time of each page matching
the query.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of HistoryItem results) {...};
- */
- export function search(query: HistoryQuery, callback: (results:
HistoryItem[]) => void): void;
- /**
- * Adds a URL to the history at the current time with a transition type
of "link".
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function addUrl(details: Url, callback?: () => void): void;
- /**
- * Removes all items within the specified date range from the history.
Pages will not be removed from the history unless all visits fall within the
range.
- * @param callback The callback parameter should be a function that
looks like this:
- * function() {...};
- */
- export function deleteRange(range: Range, callback: () => void): void;
- /**
- * Deletes all items from the history.
- * @param callback The callback parameter should be a function that
looks like this:
- * function() {...};
- */
- export function deleteAll(callback: () => void): void;
- /**
- * Retrieves information about visits to a URL.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of VisitItem results) {...};
- */
- export function getVisits(details: Url, callback: (results: VisitItem[])
=> void): void;
- /**
- * Removes all occurrences of the given URL from the history.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function deleteUrl(details: Url, callback?: () => void): void;
-
- /** Fired when a URL is visited, providing the HistoryItem data for
that URL. This event fires before the page has loaded. */
- var onVisited: HistoryVisitedEvent;
- /** Fired when one or more URLs are removed from the history service.
When all visits have been removed the URL is purged from history. */
- var onVisitRemoved: HistoryVisitRemovedEvent;
-}
-
-////////////////////
-// i18n
-////////////////////
-/**
- * Use the chrome.i18n infrastructure to implement internationalization across
your whole app or extension.
- * @since Chrome 5.
- */
-declare namespace chrome.i18n {
- /**
- * Gets the accept-languages of the browser. This is different from the
locale used by the browser; to get the locale, use i18n.getUILanguage.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of string languages) {...};
- * Parameter languages: Array of the accept languages of the browser,
such as en-US,en,zh-CN
- */
- export function getAcceptLanguages(callback: (languages: string[]) =>
void): void;
- /**
- * Gets the localized string for the specified message. If the message
is missing, this method returns an empty string (''). If the format of the
getMessage() call is wrong — for example, messageName is not a string or the
substitutions array has more than 9 elements — this method returns undefined.
- * @param messageName The name of the message, as specified in the
messages.json file.
- * @param substitutions Optional. Up to 9 substitution strings, if the
message requires any.
- */
- export function getMessage(messageName: string, substitutions?: any):
string;
- /**
- * Gets the browser UI language of the browser. This is different from
i18n.getAcceptLanguages which returns the preferred user languages.
- * @since Chrome 35.
- */
- export function getUILanguage(): string;
-}
-
-////////////////////
-// Identity
-////////////////////
-/**
- * Use the chrome.identity API to get OAuth2 access tokens.
- * Permissions: "identity"
- * @since Chrome 29.
- */
-declare namespace chrome.identity {
- /** @since Chrome 32. */
- interface AccountInfo {
- /** A unique identifier for the account. This ID will not
change for the lifetime of the account. */
- id: string;
- }
-
- interface TokenDetails {
- /**
- * Optional.
- * Fetching a token may require the user to sign-in to Chrome,
or approve the application's requested scopes. If the interactive flag is true,
getAuthToken will prompt the user as necessary. When the flag is false or
omitted, getAuthToken will return failure any time a prompt would be required.
- */
- interactive?: boolean;
- /**
- * Optional.
- * The account ID whose token should be returned. If not
specified, the primary account for the profile will be used.
- * account is only supported when the
"enable-new-profile-management" flag is set.
- * @since Chrome 37.
- */
- account?: AccountInfo;
- /**
- * Optional.
- * A list of OAuth2 scopes to request.
- * When the scopes field is present, it overrides the list of
scopes specified in manifest.json.
- * @since Chrome 37.
- */
- scopes?: string[];
- }
-
- interface UserInfo {
- /** An email address for the user account signed into the
current profile. Empty if the user is not signed in or the identity.email
manifest permission is not specified. */
- email: string;
- /** A unique identifier for the account. This ID will not
change for the lifetime of the account. Empty if the user is not signed in or
(in M41+) the identity.email manifest permission is not specified. */
- id: string;
- }
-
- interface TokenInformation {
- /** The specific token that should be removed from the cache. */
- token: string;
- }
-
- interface WebAuthFlowOptions {
- /** The URL that initiates the auth flow. */
- url: string;
- /**
- * Optional.
- * Whether to launch auth flow in interactive mode.
- * Since some auth flows may immediately redirect to a result
URL, launchWebAuthFlow hides its web view until the first navigation either
redirects to the final URL, or finishes loading a page meant to be displayed.
- * If the interactive flag is true, the window will be
displayed when a page load completes. If the flag is false or omitted,
launchWebAuthFlow will return with an error if the initial navigation does not
complete the flow.
- */
- interactive?: boolean;
- }
-
- interface SignInChangeEvent extends chrome.events.Event<(account:
AccountInfo, signedIn: boolean) => void> {}
-
- /**
- * Retrieves a list of AccountInfo objects describing the accounts
present on the profile.
- * getAccounts is only supported on dev channel.
- * Dev channel only.
- */
- export function getAccounts(callback: (accounts: AccountInfo[]) =>
void): void;
- /**
- * Gets an OAuth2 access token using the client ID and scopes specified
in the oauth2 section of manifest.json.
- * The Identity API caches access tokens in memory, so it's ok to call
getAuthToken non-interactively any time a token is required. The token cache
automatically handles expiration.
- * For a good user experience it is important interactive token
requests are initiated by UI in your app explaining what the authorization is
for. Failing to do this will cause your users to get authorization requests, or
Chrome sign in screens if they are not signed in, with with no context. In
particular, do not use getAuthToken interactively when your app is first
launched.
- * @param details Token options.
- * @param callback Called with an OAuth2 access token as specified by
the manifest, or undefined if there was an error.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(string token) {...};
- */
- export function getAuthToken(details: TokenDetails, callback?: (token:
string) => void): void;
- /**
- * Retrieves email address and obfuscated gaia id of the user signed
into a profile.
- * This API is different from identity.getAccounts in two ways. The
information returned is available offline, and it only applies to the primary
account for the profile.
- * @since Chrome 37.
- */
- export function getProfileUserInfo(callback: (userInfo: UserInfo) =>
void): void;
- /**
- * Removes an OAuth2 access token from the Identity API's token cache.
- * If an access token is discovered to be invalid, it should be passed
to removeCachedAuthToken to remove it from the cache. The app may then retrieve
a fresh token with getAuthToken.
- * @param details Token information.
- * @param callback Called when the token has been removed from the
cache.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function removeCachedAuthToken(details: TokenInformation,
callback?: () => void): void;
- /**
- * Starts an auth flow at the specified URL.
- * This method enables auth flows with non-Google identity providers by
launching a web view and navigating it to the first URL in the provider's auth
flow. When the provider redirects to a URL matching the pattern
https://<app-id>.chromiumapp.org/*, the window will close, and the final
redirect URL will be passed to the callback function.
- * For a good user experience it is important interactive auth flows
are initiated by UI in your app explaining what the authorization is for.
Failing to do this will cause your users to get authorization requests with no
context. In particular, do not launch an interactive auth flow when your app is
first launched.
- * @param details WebAuth flow options.
- * @param callback Called with the URL redirected back to your
application.
- * The callback parameter should be a function that looks like this:
- * function(string responseUrl) {...};
- */
- export function launchWebAuthFlow(details: WebAuthFlowOptions,
callback: (responseUrl?: string) => void): void;
- /**
- * Generates a redirect URL to be used in launchWebAuthFlow.
- * The generated URLs match the pattern
https://<app-id>.chromiumapp.org/*.
- * @since Chrome 33.
- * @param path Optional. The path appended to the end of the generated
URL.
- */
- export function getRedirectURL(path?: string): string;
-
- /**
- * Fired when signin state changes for an account on the user's profile.
- * @since Chrome 33.
- */
- var onSignInChanged: SignInChangeEvent;
-}
-
-////////////////////
-// Idle
-////////////////////
-/**
- * Use the chrome.idle API to detect when the machine's idle state changes.
- * Permissions: "idle"
- * @since Chrome 6.
- */
-declare namespace chrome.idle {
- interface IdleStateChangedEvent extends chrome.events.Event<(newState:
string) => void> {}
-
- /**
- * Returns "locked" if the system is locked, "idle" if the user has not
generated any input for a specified number of seconds, or "active" otherwise.
- * @param detectionIntervalInSeconds The system is considered idle if
detectionIntervalInSeconds seconds have elapsed since the last user input
detected.
- * Since Chrome 25.
- * @param callback The callback parameter should be a function that
looks like this:
- * function( IdleState newState) {...};
- */
- export function queryState(detectionIntervalInSeconds: number,
callback: (newState: string) => void): void;
- /**
- * Sets the interval, in seconds, used to determine when the system is
in an idle state for onStateChanged events. The default interval is 60 seconds.
- * @since Chrome 25.
- * @param intervalInSeconds Threshold, in seconds, used to determine
when the system is in an idle state.
- */
- export function setDetectionInterval(intervalInSeconds: number): void;
-
- /** Fired when the system changes to an active, idle or locked state.
The event fires with "locked" if the screen is locked or the screensaver
activates, "idle" if the system is unlocked and the user has not generated any
input for a specified number of seconds, and "active" when the user generates
input on an idle system. */
- var onStateChanged: IdleStateChangedEvent;
-}
-
-////////////////////
-// Input - IME
-////////////////////
-/**
- * Use the chrome.input.ime API to implement a custom IME for Chrome OS. This
allows your extension to handle keystrokes, set the composition, and manage the
candidate window.
- * Permissions: "input"
- * @since Chrome 21.
- */
-declare namespace chrome.input.ime {
- /** See http://www.w3.org/TR/DOM-Level-3-Events/#events-KeyboardEvent */
- interface KeyboardEvent {
- /**
- * Optional.
- * Whether or not the SHIFT key is pressed.
- */
- shiftKey?: boolean;
- /**
- * Optional.
- * Whether or not the ALT key is pressed.
- */
- altKey?: boolean;
- /** The ID of the request. */
- requestId: string;
- /** Value of the key being pressed */
- key: string;
- /**
- * Optional.
- * Whether or not the CTRL key is pressed.
- */
- ctrlKey?: boolean;
- /** One of keyup or keydown. */
- type: string;
- /**
- * Optional.
- * The extension ID of the sender of this keyevent.
- * @since Chrome 34.
- */
- extensionId?: string;
- /**
- * Optional.
- * Value of the physical key being pressed. The value is not
affected by current keyboard layout or modifier state.
- * @since Chrome 26.
- */
- code: string;
- /**
- * Optional.
- * The deprecated HTML keyCode, which is system- and
implementation-dependent numerical code signifying the unmodified identifier
associated with the key pressed.
- * @since Chrome 37.
- */
- keyCode?: number;
- /**
- * Optional.
- * Whether or not the CAPS_LOCK is enabled.
- * @since Chrome 29.
- */
- capsLock?: boolean;
- }
-
- /** Describes an input Context */
- interface InputContext {
- /** This is used to specify targets of text field operations.
This ID becomes invalid as soon as onBlur is called. */
- contextID: number;
- /** Type of value this text field edits, (Text, Number, URL,
etc) */
- type: string;
- /**
- * Whether the text field wants auto-correct.
- * @since Chrome 40.
- */
- autoCorrect: boolean;
- /**
- * Whether the text field wants auto-complete.
- * @since Chrome 40.
- */
- autoComplete: boolean;
- /**
- * Whether the text field wants spell-check.
- * @since Chrome 40.
- */
- spellCheck: boolean;
- }
-
- /**
- * A menu item used by an input method to interact with the user from
the language menu.
- * @since Chrome 30.
- */
- interface MenuItem {
- /** String that will be passed to callbacks referencing this
MenuItem. */
- id: string;
- /** Optional. Text displayed in the menu for this item. */
- label?: string;
- /** Optional. The type of menu item. */
- style?: string;
- /** Optional. Indicates this item is visible. */
- visible?: boolean;
- /** Indicates this item should be drawn with a check. */
- checked?: boolean;
- /** Indicates this item is enabled. */
- enabled?: boolean;
- }
-
- interface ImeParameters {
- /** MenuItems to use. */
- items: MenuItem[];
- /** ID of the engine to use */
- engineID: string;
- }
-
- interface CommitTextParameters {
- /** The text to commit */
- text: string;
- /** ID of the context where the text will be committed */
- contextID: number;
- }
-
- interface CandidateUsage {
- /** The title string of details description. */
- title: string;
- /** The body string of detail description. */
- body: string;
- }
-
- interface CandidateTemplate {
- /** The candidate */
- candidate: string;
- /** The candidate's id */
- id: number;
- /**
- * Optional.
- * The id to add these candidates under
- */
- parentId?: number;
- /**
- * Optional.
- * Short string displayed to next to the candidate, often the
shortcut key or index
- */
- label?: string;
- /**
- * Optional.
- * Additional text describing the candidate
- */
- annotation?: string;
- /**
- * Optional.
- * The usage or detail description of word.
- */
- usage?: CandidateUsage;
- }
-
- interface CandidatesParameters {
- /** ID of the context that owns the candidate window. */
- contextID: number;
- /** List of candidates to show in the candidate window */
- candidates: CandidateTemplate[];
- }
-
- interface CompositionParameterSegment {
- /** Index of the character to start this segment at */
- start: number;
- /** Index of the character to end this segment after. */
- end: number;
- /** The type of the underline to modify this segment. */
- style: string;
- }
-
- interface CompositionParameters {
- /** ID of the context where the composition text will be set */
- contextID: number;
- /** Text to set */
- text: string;
- /** Optional. List of segments and their associated types. */
- segments: CompositionParameterSegment[];
- /** Position in the text of the cursor. */
- cursor: number;
- /** Optional. Position in the text that the selection starts
at. */
- selectionStart?: number;
- /** Optional. Position in the text that the selection ends at.
*/
- selectionEnd?: number;
- }
-
- interface MenuItemParameters {
- items: Object[];
- engineId: string;
- }
-
- interface CandidateWindowParameterProperties {
- /**
- * Optional.
- * True to show the cursor, false to hide it.
- */
- cursorVisible?: boolean;
- /**
- * Optional.
- * True if the candidate window should be rendered vertical,
false to make it horizontal.
- */
- vertical?: boolean;
- /**
- * Optional.
- * The number of candidates to display per page.
- */
- pageSize?: number;
- /**
- * Optional.
- * True to display the auxiliary text, false to hide it.
- */
- auxiliaryTextVisible?: boolean;
- /**
- * Optional.
- * Text that is shown at the bottom of the candidate window.
- */
- auxiliaryText?: string;
- /**
- * Optional.
- * True to show the Candidate window, false to hide it.
- */
- visible?: boolean;
- /**
- * Optional.
- * Where to display the candidate window.
- * @since Chrome 28.
- */
- windowPosition?: string;
- }
-
- interface CandidateWindowParameter {
- /** ID of the engine to set properties on. */
- engineID: string;
- properties: CandidateWindowParameterProperties;
- }
-
- interface ClearCompositionParameters {
- /** ID of the context where the composition will be cleared */
- contextID: number;
- }
-
- interface CursorPositionParameters {
- /** ID of the candidate to select. */
- candidateID: number;
- /** ID of the context that owns the candidate window. */
- contextID: number;
- }
-
- interface SendKeyEventParameters {
- /** ID of the context where the key events will be sent, or
zero to send key events to non-input field. */
- contextID: number;
- /** Data on the key event. */
- keyData: KeyboardEvent[];
- }
-
- interface DeleteSurroundingTextParameters {
- /** ID of the engine receiving the event. */
- engineID: string;
- /** ID of the context where the surrounding text will be
deleted. */
- contextID: number;
- /** The offset from the caret position where deletion will
start. This value can be negative. */
- offset: number;
- /** The number of characters to be deleted */
- length: number;
- }
-
- interface SurroundingTextInfo {
- /** The text around cursor. */
- text: string;
- /** The ending position of the selection. This value indicates
caret position if there is no selection. */
- focus: number;
- /** The beginning position of the selection. This value
indicates caret position if is no selection. */
- anchor: number;
- }
-
- interface BlurEvent extends chrome.events.Event<(contextID: number) =>
void> {}
-
- interface CandidateClickedEvent extends chrome.events.Event<(engineID:
string, candidateID: number, button: string) => void> {}
-
- interface KeyEventEvent extends chrome.events.Event<(engineID: string,
keyData: KeyboardEvent) => void> {}
-
- interface DeactivatedEvent extends chrome.events.Event<(engineID: string)
=> void> {}
-
- interface InputContextUpdateEvent extends chrome.events.Event<(context:
InputContext) => void> {}
-
- interface ActivateEvent extends chrome.events.Event<(engineID: string,
screen: string) => void> {}
-
- interface FocusEvent extends chrome.events.Event<(context: InputContext)
=> void> {}
-
- interface MenuItemActivatedEvent extends chrome.events.Event<(engineID:
string, name: string) => void> {}
-
- interface SurroundingTextChangedEvent extends
chrome.events.Event<(engineID: string, surroundingInfo: SurroundingTextInfo) =>
void> {}
-
- interface InputResetEvent extends chrome.events.Event<(engineID:
string) => void> {}
-
- /**
- * Adds the provided menu items to the language menu when this IME is
active.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function setMenuItems(parameters: ImeParameters, callback?: ()
=> void): void;
- /**
- * Commits the provided text to the current input.
- * @param callback Called when the operation completes with a boolean
indicating if the text was accepted or not. On failure,
chrome.runtime.lastError is set.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(boolean success) {...};
- */
- export function commitText(parameters: CommitTextParameters, callback?:
(success: boolean) => void): void;
- /**
- * Sets the current candidate list. This fails if this extension
doesn't own the active IME
- * @param callback Called when the operation completes.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(boolean success) {...};
- */
- export function setCandidates(parameters: CandidatesParameters, callback?:
(success: boolean) => void): void;
- /**
- * Set the current composition. If this extension does not own the
active IME, this fails.
- * @param callback Called when the operation completes with a boolean
indicating if the text was accepted or not. On failure,
chrome.runtime.lastError is set.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(boolean success) {...};
- */
- export function setComposition(parameters: CompositionParameters,
callback?: (success: boolean) => void): void;
- /**
- * Updates the state of the MenuItems specified
- * @param callback Called when the operation completes
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function updateMenuItems(parameters: MenuItemParameters,
callback?: () => void): void;
- /**
- * Sets the properties of the candidate window. This fails if the
extension doesn't own the active IME
- * @param callback Called when the operation completes.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(boolean success) {...};
- */
- export function setCandidateWindowProperties(parameters:
CandidateWindowParameter, callback?: (success: boolean) => void): void;
- /**
- * Clear the current composition. If this extension does not own the
active IME, this fails.
- * @param callback Called when the operation completes with a boolean
indicating if the text was accepted or not. On failure,
chrome.runtime.lastError is set.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(boolean success) {...};
- */
- export function clearComposition(parameters: ClearCompositionParameters,
callback?: (success: boolean) => void): void;
- /**
- * Set the position of the cursor in the candidate window. This is a
no-op if this extension does not own the active IME.
- * @param callback Called when the operation completes
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(boolean success) {...};
- */
- export function setCursorPosition(parameters: CursorPositionParameters,
callback?: (success: boolean) => void): void;
- /**
- * Sends the key events. This function is expected to be used by
virtual keyboards. When key(s) on a virtual keyboard is pressed by a user, this
function is used to propagate that event to the system.
- * @since Chrome 33.
- * @param callback Called when the operation completes.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function sendKeyEvents(parameters: SendKeyEventParameters,
callback?: () => void): void;
- /**
- * Hides the input view window, which is popped up automatically by
system. If the input view window is already hidden, this function will do
nothing.
- * @since Chrome 34.
- */
- export function hideInputView(): void;
- /**
- * Deletes the text around the caret.
- * @since Chrome 27.
- */
- export function deleteSurroundingText(parameters:
DeleteSurroundingTextParameters, callback?: () => void): void;
- /**
- * Indicates that the key event received by onKeyEvent is handled. This
should only be called if the onKeyEvent listener is asynchronous.
- * @since Chrome 25.
- * @param requestId Request id of the event that was handled. This
should come from keyEvent.requestId
- * @param response True if the keystroke was handled, false if not
- */
- export function keyEventHandled(requestId: string, response: boolean):
void;
-
- /** This event is sent when focus leaves a text box. It is sent to all
extensions that are listening to this event, and enabled by the user. */
- var onBlur: BlurEvent;
- /** This event is sent if this extension owns the active IME. */
- var onCandidateClicked: CandidateClickedEvent;
- /** This event is sent if this extension owns the active IME. */
- var onKeyEvent: KeyEventEvent;
- /** This event is sent when an IME is deactivated. It signals that the
IME will no longer be receiving onKeyPress events. */
- var onDeactivated: DeactivatedEvent;
- /** This event is sent when the properties of the current InputContext
change, such as the the type. It is sent to all extensions that are listening
to this event, and enabled by the user. */
- var onInputContextUpdate: InputContextUpdateEvent;
- /** This event is sent when an IME is activated. It signals that the
IME will be receiving onKeyPress events. */
- var onActivate: ActivateEvent;
- /** This event is sent when focus enters a text box. It is sent to all
extensions that are listening to this event, and enabled by the user. */
- var onFocus: FocusEvent;
- /** Called when the user selects a menu item */
- var onMenuItemActivated: MenuItemActivatedEvent;
- /**
- * Called when the editable string around caret is changed or when the
caret position is moved. The text length is limited to 100 characters for each
back and forth direction.
- * @since Chrome 27.
- */
- var onSurroundingTextChanged: SurroundingTextChangedEvent;
- /**
- * This event is sent when chrome terminates ongoing text input session.
- * @since Chrome 29.
- */
- var onReset: InputResetEvent;
-}
-
-////////////////////
-// Management
-////////////////////
-/**
- * The chrome.management API provides ways to manage the list of
extensions/apps that are installed and running. It is particularly useful for
extensions that override the built-in New Tab page.
- * Permissions: "management"
- * @since Chrome 8.
- */
-declare namespace chrome.management {
- /** Information about an installed extension, app, or theme. */
- interface ExtensionInfo {
- /**
- * Optional.
- * A reason the item is disabled.
- * @since Chrome 17.
- */
- disabledReason?: string;
- /** Optional. The launch url (only present for apps). */
- appLaunchUrl?: string;
- /**
- * The description of this extension, app, or theme.
- * @since Chrome 9.
- */
- description: string;
- /**
- * Returns a list of API based permissions.
- * @since Chrome 9.
- */
- permissions: string[];
- /**
- * Optional.
- * A list of icon information. Note that this just reflects
what was declared in the manifest, and the actual image at that url may be
larger or smaller than what was declared, so you might consider using explicit
width and height attributes on img tags referencing these images. See the
manifest documentation on icons for more details.
- */
- icons?: IconInfo[];
- /**
- * Returns a list of host based permissions.
- * @since Chrome 9.
- */
- hostPermissions: string[];
- /** Whether it is currently enabled or disabled. */
- enabled: boolean;
- /**
- * Optional.
- * The URL of the homepage of this extension, app, or theme.
- * @since Chrome 11.
- */
- homepageUrl?: string;
- /**
- * Whether this extension can be disabled or uninstalled by the
user.
- * @since Chrome 12.
- */
- mayDisable: boolean;
- /**
- * How the extension was installed.
- * @since Chrome 22.
- */
- installType: string;
- /** The version of this extension, app, or theme. */
- version: string;
- /** The extension's unique identifier. */
- id: string;
- /**
- * Whether the extension, app, or theme declares that it
supports offline.
- * @since Chrome 15.
- */
- offlineEnabled: boolean;
- /**
- * Optional.
- * The update URL of this extension, app, or theme.
- * @since Chrome 16.
- */
- updateUrl?: string;
- /**
- * The type of this extension, app, or theme.
- * @since Chrome 23.
- */
- type: string;
- /** The url for the item's options page, if it has one. */
- optionsUrl: string;
- /** The name of this extension, app, or theme. */
- name: string;
- /**
- * A short version of the name of this extension, app, or theme.
- * @since Chrome 31.
- */
- shortName: string;
- /**
- * True if this is an app.
- * @deprecated since Chrome 33. Please use
management.ExtensionInfo.type.
- */
- isApp: boolean;
- /**
- * Optional.
- * The app launch type (only present for apps).
- * @since Chrome 37.
- */
- launchType?: string;
- /**
- * Optional.
- * The currently available launch types (only present for apps).
- * @since Chrome 37.
- */
- availableLaunchTypes?: string[];
- }
-
- /** Information about an icon belonging to an extension, app, or theme.
*/
- interface IconInfo {
- /** The URL for this icon image. To display a grayscale version
of the icon (to indicate that an extension is disabled, for example), append
?grayscale=true to the URL. */
- url: string;
- /** A number representing the width and height of the icon.
Likely values include (but are not limited to) 128, 48, 24, and 16. */
- size: number;
- }
-
- interface UninstallOptions {
- /**
- * Optional.
- * Whether or not a confirm-uninstall dialog should prompt the
user. Defaults to false for self uninstalls. If an extension uninstalls another
extension, this parameter is ignored and the dialog is always shown.
- */
- showConfirmDialog?: boolean;
- }
-
- interface ManagementDisabledEvent extends chrome.events.Event<(info:
ExtensionInfo) => void> {}
-
- interface ManagementUninstalledEvent extends chrome.events.Event<(id:
string) => void> {}
-
- interface ManagementInstalledEvent extends chrome.events.Event<(info:
ExtensionInfo) => void> {}
-
- interface ManagementEnabledEvent extends chrome.events.Event<(info:
ExtensionInfo) => void> {}
-
- /**
- * Enables or disables an app or extension.
- * @param id This should be the id from an item of
management.ExtensionInfo.
- * @param enabled Whether this item should be enabled or disabled.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function setEnabled(id: string, enabled: boolean, callback?: ()
=> void): void;
- /**
- * Returns a list of permission warnings for the given extension id.
- * @since Chrome 15.
- * @param id The ID of an already installed extension.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(array of string permissionWarnings) {...};
- */
- export function getPermissionWarningsById(id: string, callback?:
(permissionWarnings: string[]) => void): void;
- /**
- * Returns information about the installed extension, app, or theme
that has the given ID.
- * @since Chrome 9.
- * @param id The ID from an item of management.ExtensionInfo.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function( ExtensionInfo result) {...};
- */
- export function get(id: string, callback?: (result: ExtensionInfo) =>
void): void;
- /**
- * Returns a list of information about installed extensions and apps.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(array of ExtensionInfo result) {...};
- */
- export function getAll(callback?: (result: ExtensionInfo[]) => void): void;
- /**
- * Returns a list of permission warnings for the given extension
manifest string. Note: This function can be used without requesting the
'management' permission in the manifest.
- * @since Chrome 15.
- * @param manifestStr Extension manifest JSON string.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(array of string permissionWarnings) {...};
- */
- export function getPermissionWarningsByManifest(manifestStr: string,
callback?: (permissionwarnings: string[]) => void): void;
- /**
- * Launches an application.
- * @param id The extension id of the application.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function launchApp(id: string, callback?: () => void): void;
- /**
- * Uninstalls a currently installed app or extension.
- * @since Chrome 21.
- * @param id This should be the id from an item of
management.ExtensionInfo.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function uninstall(id: string, options?: UninstallOptions,
callback?: () => void): void;
- /**
- * Uninstalls a currently installed app or extension.
- * @deprecated since Chrome 21. The options parameter was added to this
function.
- * @param id This should be the id from an item of
management.ExtensionInfo.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function uninstall(id: string, callback?: () => void): void;
- /**
- * Returns information about the calling extension, app, or theme.
Note: This function can be used without requesting the 'management' permission
in the manifest.
- * @since Chrome 39.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function( ExtensionInfo result) {...};
- */
- export function getSelf(callback?: (result: ExtensionInfo) => void):
void;
- /**
- * Uninstalls the calling extension.
- * Note: This function can be used without requesting the 'management'
permission in the manifest.
- * @since Chrome 26.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function uninstallSelf(options?: UninstallOptions, callback?: ()
=> void): void;
- /**
- * Uninstalls the calling extension.
- * Note: This function can be used without requesting the 'management'
permission in the manifest.
- * @since Chrome 26.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function uninstallSelf(callback?: () => void): void;
- /**
- * Display options to create shortcuts for an app. On Mac, only
packaged app shortcuts can be created.
- * @since Chrome 37.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function createAppShortcut(id: string, callback?: () => void):
void;
- /**
- * Set the launch type of an app.
- * @since Chrome 37.
- * @param id This should be the id from an app item of
management.ExtensionInfo.
- * @param launchType The target launch type. Always check and make sure
this launch type is in ExtensionInfo.availableLaunchTypes, because the
available launch types vary on different platforms and configurations.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function setLaunchType(id: string, launchType: string,
callback?: () => void): void;
- /**
- * Generate an app for a URL. Returns the generated bookmark app.
- * @since Chrome 37.
- * @param url The URL of a web page. The scheme of the URL can only be
"http" or "https".
- * @param title The title of the generated app.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function( ExtensionInfo result) {...};
- */
- export function generateAppForLink(url: string, title: string,
callback?: (result: ExtensionInfo) => void): void;
-
- /** Fired when an app or extension has been disabled. */
- var onDisabled: ManagementDisabledEvent;
- /** Fired when an app or extension has been uninstalled. */
- var onUninstalled: ManagementUninstalledEvent;
- /** Fired when an app or extension has been installed. */
- var onInstalled: ManagementInstalledEvent;
- /** Fired when an app or extension has been enabled. */
- var onEnabled: ManagementEnabledEvent;
-}
-
-////////////////////
-// Notifications
-////////////////////
-/**
- * Use the networking.config API to authenticate to captive portals.
- * Permissions: "networking.config"
- * Important: This API works only on Chrome OS.
- * @since Chrome 43.
- */
-declare namespace chrome.networking.config {
- interface NetworkInfo {
- /** Currently only WiFi supported. */
- Type: string;
- /** Optional. A unique identifier of the network. */
- GUID?: string;
- /** Optional. A hex-encoded byte sequence. */
- HexSSID?: string;
- /** Optional. The decoded SSID of the network (default encoding
is UTF-8). To filter for non-UTF-8 SSIDs, use HexSSID instead. */
- SSID?: string;
- /** Optional. The basic service set identification (BSSID)
uniquely identifying the basic service set. BSSID is represented as a human
readable, hex-encoded string with bytes separated by colons, e.g.
45:67:89:ab:cd:ef. */
- BSSID?: string;
- /** Optional. Identifier indicating the security type of the
network. Valid values are None, WEP-PSK, WPA-PSK and WPA-EAP. */
- Security?: string;
- }
-
- interface CaptivePorttalDetectedEvent extends
chrome.events.Event<(networkInfo: NetworkInfo) => void> {}
-
- /**
- * Allows an extension to define network filters for the networks it
can handle. A call to this function will remove all filters previously
installed by the extension before setting the new list.
- * @param networks Network filters to set. Every NetworkInfo must
either have the SSID or HexSSID set. Other fields will be ignored.
- * @param callback Called back when this operation is finished.
- * The callback parameter should be a function that looks like this:
- * function() {...};
- */
- export function setNetworkFilter(networks: NetworkInfo[], callback: ()
=> void): void;
- /**
- * Called by the extension to notify the network config API that it
finished a captive portal authentication attempt and hand over the result of
the attempt. This function must only be called with the GUID of the latest
onCaptivePortalDetected event.
- * @param GUID Unique network identifier obtained from
onCaptivePortalDetected.
- * @param result The result of the authentication attempt.
- * unhandled: The extension does not handle this network or captive
portal (e.g. server end-point not found or not compatible).
- * succeeded: The extension handled this network and authenticated
successfully.
- * rejected: The extension handled this network, tried to authenticate,
however was rejected by the server.
- * failed: The extension handled this network, tried to authenticate,
however failed due to an unspecified error.
- * @param callback Called back when this operation is finished.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function() {...};
- */
- export function finishAuthentication(GUID: string, result: string,
callback?: () => void): void;
-
- /** This event fires everytime a captive portal is detected on a
network matching any of the currently registered network filters and the user
consents to use the extension for authentication. Network filters may be set
using the setNetworkFilter. Upon receiving this event the extension should
start its authentication attempt with the captive portal. When the extension
finishes its attempt, it must call finishAuthentication with the GUID received
with this event and the appropriate auth [...]
- var onCaptivePortalDetected: CaptivePorttalDetectedEvent;
-}
-
-////////////////////
-// Notifications
-// https://developer.chrome.com/extensions/notifications
-////////////////////
-/**
- * Use the chrome.notifications API to create rich notifications using
templates and show these notifications to users in the system tray.
- * Permissions: "notifications"
- * @since Chrome 28.
- */
-declare namespace chrome.notifications {
- interface ButtonOptions {
- title: string;
- iconUrl?: string;
- }
-
- interface ItemOptions {
- /** Title of one item of a list notification. */
- title: string;
- /** Additional details about this item. */
- message: string;
- }
-
- interface NotificationOptions {
- /** Optional. Which type of notification to display. Required
for notifications.create method. */
- type?: string;
- /**
- * Optional.
- * A URL to the sender's avatar, app icon, or a thumbnail for
image notifications.
- * URLs can be a data URL, a blob URL, or a URL relative to a
resource within this extension's .crx file Required for notifications.create
method.
- */
- iconUrl?: string;
- /** Optional. Title of the notification (e.g. sender name for
email). Required for notifications.create method. */
- title?: string;
- /** Optional. Main notification content. Required for
notifications.create method. */
- message?: string;
- /**
- * Optional.
- * Alternate notification content with a lower-weight font.
- * @since Chrome 31.
- */
- contextMessage?: string;
- /** Optional. Priority ranges from -2 to 2. -2 is lowest
priority. 2 is highest. Zero is default. */
- priority?: number;
- /** Optional. A timestamp associated with the notification, in
milliseconds past the epoch (e.g. Date.now() + n). */
- eventTime?: number;
- /** Optional. Text and icons for up to two notification action
buttons. */
- buttons?: ButtonOptions[];
- /** Optional. Items for multi-item notifications. */
- items?: ItemOptions[];
- /**
- * Optional.
- * Current progress ranges from 0 to 100.
- * @since Chrome 30.
- */
- progress?: number;
- /**
- * Optional.
- * Whether to show UI indicating that the app will visibly
respond to clicks on the body of a notification.
- * @since Chrome 32.
- */
- isClickable?: boolean;
- /**
- * Optional.
- * A URL to the app icon mask. URLs have the same restrictions
as iconUrl. The app icon mask should be in alpha channel, as only the alpha
channel of the image will be considered.
- * @since Chrome 38.
- */
- appIconMaskUrl?: string;
- /** Optional. A URL to the image thumbnail for image-type
notifications. URLs have the same restrictions as iconUrl. */
- imageUrl?: string;
- }
-
- interface NotificationClosedEvent extends
chrome.events.Event<(notificationId: string, byUser: boolean) => void> {}
-
- interface NotificationClickedEvent extends
chrome.events.Event<(notificationId: string) => void> {}
-
- interface NotificationButtonClickedEvent extends
chrome.events.Event<(notificationId: string, buttonIndex: number) => void> {}
-
- interface NotificationPermissionLevelChangedEvent extends
chrome.events.Event<(level: string) => void> {}
-
- interface NotificationShowSettingsEvent extends chrome.events.Event<()
=> void> {}
-
- /** The notification closed, either by the system or by user action. */
- export var onClosed: NotificationClosedEvent;
- /** The user clicked in a non-button area of the notification. */
- export var onClicked: NotificationClickedEvent;
- /** The user pressed a button in the notification. */
- export var onButtonClicked: NotificationButtonClickedEvent;
- /**
- * The user changes the permission level.
- * @since Chrome 32.
- */
- export var onPermissionLevelChanged:
NotificationPermissionLevelChangedEvent;
- /**
- * The user clicked on a link for the app's notification settings.
- * @since Chrome 32.
- */
- export var onShowSettings: NotificationShowSettingsEvent;
-
- /**
- * Creates and displays a notification.
- * @param notificationId Identifier of the notification. If not set or
empty, an ID will automatically be generated. If it matches an existing
notification, this method first clears that notification before proceeding with
the create operation.
- * The notificationId parameter is required before Chrome 42.
- * @param options Contents of the notification.
- * @param callback Returns the notification id (either supplied or
generated) that represents the created notification.
- * The callback is required before Chrome 42.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(string notificationId) {...};
- */
- export function create(notificationId: string, options:
NotificationOptions, callback?: (notificationId: string) => void): void;
- /**
- * Creates and displays a notification.
- * @param notificationId Identifier of the notification. If not set or
empty, an ID will automatically be generated. If it matches an existing
notification, this method first clears that notification before proceeding with
the create operation.
- * The notificationId parameter is required before Chrome 42.
- * @param options Contents of the notification.
- * @param callback Returns the notification id (either supplied or
generated) that represents the created notification.
- * The callback is required before Chrome 42.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(string notificationId) {...};
- */
- export function create(options: NotificationOptions, callback?:
(notificationId: string) => void): void;
- /**
- * Updates an existing notification.
- * @param notificationId The id of the notification to be updated. This
is returned by notifications.create method.
- * @param options Contents of the notification to update to.
- * @param callback Called to indicate whether a matching notification
existed.
- * The callback is required before Chrome 42.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(boolean wasUpdated) {...};
- */
- export function update(notificationId: string, options:
NotificationOptions, callback?: (wasUpdated: boolean) => void): void;
- /**
- * Clears the specified notification.
- * @param notificationId The id of the notification to be cleared. This
is returned by notifications.create method.
- * @param callback Called to indicate whether a matching notification
existed.
- * The callback is required before Chrome 42.
- * If you specify the callback parameter, it should be a function that
looks like this:
- * function(boolean wasCleared) {...};
- */
- export function clear(notificationId: string, callback?: (wasCleared:
boolean) => void): void;
- /**
- * Retrieves all the notifications.
- * @since Chrome 29.
- * @param callback Returns the set of notification_ids currently in the
system.
- * The callback parameter should be a function that looks like this:
- * function(object notifications) {...};
- */
- export function getAll(callback: (notifications: Object) => void): void;
- /**
- * Retrieves whether the user has enabled notifications from this app
or extension.
- * @since Chrome 32.
- * @param callback Returns the current permission level.
- * The callback parameter should be a function that looks like this:
- * function( PermissionLevel level) {...};
- */
- export function getPermissionLevel(callback: (level: string) => void):
void;
-}
-
-////////////////////
-// Omnibox
-////////////////////
-/**
- * The omnibox API allows you to register a keyword with Google Chrome's
address bar, which is also known as the omnibox.
- * Manifest: "omnibox": {...}
- * @since Chrome 9.
- */
-declare namespace chrome.omnibox {
- /** A suggest result. */
- interface SuggestResult {
- /** The text that is put into the URL bar, and that is sent to
the extension when the user chooses this entry. */
- content: string;
- /** The text that is displayed in the URL dropdown. Can contain
XML-style markup for styling. The supported tags are 'url' (for a literal URL),
'match' (for highlighting text that matched what the user's query), and 'dim'
(for dim helper text). The styles can be nested, eg. dimmed match. You must
escape the five predefined entities to display them as text:
stackoverflow.com/a/1091953/89484 */
- description: string;
- }
-
- interface Suggestion {
- /** The text that is displayed in the URL dropdown. Can contain
XML-style markup for styling. The supported tags are 'url' (for a literal URL),
'match' (for highlighting text that matched what the user's query), and 'dim'
(for dim helper text). The styles can be nested, eg. dimmed match. */
- description: string;
- }
-
- interface OmniboxInputEnteredEvent extends chrome.events.Event<(text:
string) => void> {}
-
- interface OmniboxInputChangedEvent extends chrome.events.Event<(text:
string, suggest: (suggestResults: SuggestResult[]) => void) => void> {}
-
- interface OmniboxInputStartedEvent extends chrome.events.Event<() => void>
{}
-
- interface OmniboxInputCancelledEvent extends chrome.events.Event<() =>
void> {}
-
- /**
- * Sets the description and styling for the default suggestion. The
default suggestion is the text that is displayed in the first suggestion row
underneath the URL bar.
- * @param suggestion A partial SuggestResult object, without the
'content' parameter.
- */
- export function setDefaultSuggestion(suggestion: Suggestion): void;
-
- /** User has accepted what is typed into the omnibox. */
- var onInputEntered: OmniboxInputEnteredEvent;
- /** User has changed what is typed into the omnibox. */
- var onInputChanged: OmniboxInputChangedEvent;
- /** User has started a keyword input session by typing the extension's
keyword. This is guaranteed to be sent exactly once per input session, and
before any onInputChanged events. */
- var onInputStarted: OmniboxInputStartedEvent;
- /** User has ended the keyword input session without accepting the
input. */
- var onInputCancelled: OmniboxInputCancelledEvent;
-}
-
-////////////////////
-// Page Action
-////////////////////
-/**
- * Use the chrome.pageAction API to put icons inside the address bar. Page
actions represent actions that can be taken on the current page, but that
aren't applicable to all pages.
- * Manifest: "page_action": {...}
- * @since Chrome 5.
- */
-declare namespace chrome.pageAction {
- interface PageActionClickedEvent extends chrome.events.Event<(tab:
chrome.tabs.Tab) => void> {}
-
- interface TitleDetails {
- /** The id of the tab for which you want to modify the page
action. */
- tabId: number;
- /** The tooltip string. */
- title: string;
- }
-
- interface GetDetails {
- /** Specify the tab to get the title from. */
- tabId: number;
- }
-
- interface PopupDetails {
- /** The id of the tab for which you want to modify the page
action. */
- tabId: number;
- /** The html file to show in a popup. If set to the empty
string (''), no popup is shown. */
- popup: string;
- }
-
- interface IconDetails {
- /** The id of the tab for which you want to modify the page
action. */
- tabId: number;
- /**
- * Optional.
- * @deprecated This argument is ignored.
- */
- iconIndex?: number;
- /**
- * Optional.
- * Either an ImageData object or a dictionary {size ->
ImageData} representing icon to be set. If the icon is specified as a
dictionary, the actual image to be used is chosen depending on screen's pixel
density. If the number of image pixels that fit into one screen space unit
equals scale, then image with size scale * 19 will be selected. Initially only
scales 1 and 2 will be supported. At least one image must be specified. Note
that 'details.imageData = foo' is equivalent to 'details [...]
- */
- imageData?: ImageData;
- /**
- * Optional.
- * Either a relative image path or a dictionary {size ->
relative image path} pointing to icon to be set. If the icon is specified as a
dictionary, the actual image to be used is chosen depending on screen's pixel
density. If the number of image pixels that fit into one screen space unit
equals scale, then image with size scale * 19 will be selected. Initially only
scales 1 and 2 will be supported. At least one image must be specified. Note
that 'details.path = foo' is equivalent to 'd [...]
- */
- path?: any;
- }
-
- /**
- * Shows the page action. The page action is shown whenever the tab is
selected.
- * @param tabId The id of the tab for which you want to modify the page
action.
- */
- export function hide(tabId: number): void;
- /**
- * Shows the page action. The page action is shown whenever the tab is
selected.
- * @param tabId The id of the tab for which you want to modify the page
action.
- */
- export function show(tabId: number): void;
- /** Sets the title of the page action. This is displayed in a tooltip
over the page action. */
- export function setTitle(details: TitleDetails): void;
- /** Sets the html document to be opened as a popup when the user clicks
on the page action's icon. */
- export function setPopup(details: PopupDetails): void;
- /**
- * Gets the title of the page action.
- * @since Chrome 19.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(string result) {...};
- */
- export function getTitle(details: GetDetails, callback: (result: string)
=> void): void;
- /**
- * Gets the html document set as the popup for this page action.
- * @since Chrome 19.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(string result) {...};
- */
- export function getPopup(details: GetDetails, callback: (result: string)
=> void): void;
- /**
- * Sets the icon for the page action. The icon can be specified either
as the path to an image file or as the pixel data from a canvas element, or as
dictionary of either one of those. Either the path or the imageData property
must be specified.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function() {...};
- */
- export function setIcon(details: IconDetails, callback?: () => void):
void;
-
- /** Fired when a page action icon is clicked. This event will not fire
if the page action has a popup. */
- var onClicked: PageActionClickedEvent;
-}
-
-////////////////////
-// Page Capture
-////////////////////
-/**
- * Use the chrome.pageCapture API to save a tab as MHTML.
- * Permissions: "pageCapture"
- * @since Chrome 18.
- */
-declare namespace chrome.pageCapture {
- interface SaveDetails {
- /** The id of the tab to save as MHTML. */
- tabId: number;
- }
-
- /**
- * Saves the content of the tab with given id as MHTML.
- * @param callback Called when the MHTML has been generated.
- * The callback parameter should be a function that looks like this:
- * function(binary mhtmlData) {...};
- * Parameter mhtmlData: The MHTML data as a Blob.
- */
- export function saveAsMHTML(details: SaveDetails, callback: (mhtmlData:
any) => void): void;
-}
-
-////////////////////
-// Permissions
-////////////////////
-/**
- * Use the chrome.permissions API to request declared optional permissions at
run time rather than install time, so users understand why the permissions are
needed and grant only those that are necessary.
- * @since Chrome 16.
- */
-declare namespace chrome.permissions {
- interface Permissions {
- /**
- * Optional.
- * List of named permissions (does not include hosts or
origins). Anything listed here must appear in the optional_permissions list in
the manifest.
- */
- origins?: string[];
- /**
- * Optional.
- * List of origin permissions. Anything listed here must be a
subset of a host that appears in the optional_permissions list in the manifest.
For example, if http://*.example.com/ or http://* appears in
optional_permissions, you can request an origin of http://help.example.com/.
Any path is ignored.
- */
- permissions?: string[];
- }
-
- interface PermissionsRemovedEvent {
- /**
- * @param callback The callback parameter should be a function
that looks like this:
- * function( Permissions permissions) {...};
- * Parameter permissions: The permissions that have been
removed.
- */
- addListener(callback: (permissions: Permissions) => void): void;
- }
-
- interface PermissionsAddedEvent {
- /**
- * @param callback The callback parameter should be a function
that looks like this:
- * function( Permissions permissions) {...};
- * Parameter permissions: The newly acquired permissions.
- */
- addListener(callback: (permissions: Permissions) => void): void;
- }
-
- /**
- * Checks if the extension has the specified permissions.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(boolean result) {...};
- * Parameter result: True if the extension has the specified
permissions.
- */
- export function contains(permissions: Permissions, callback: (result:
boolean) => void): void;
- /**
- * Gets the extension's current set of permissions.
- * @param callback The callback parameter should be a function that
looks like this:
- * function( Permissions permissions) {...};
- * Parameter permissions: The extension's active permissions.
- */
- export function getAll(callback: (permissions: Permissions) => void): void;
- /**
- * Requests access to the specified permissions. These permissions must
be defined in the optional_permissions field of the manifest. If there are any
problems requesting the permissions, runtime.lastError will be set.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(boolean granted) {...};
- * Parameter granted: True if the user granted the specified
permissions.
- */
- export function request(permissions: Permissions, callback?: (granted:
boolean) => void): void;
- /**
- * Removes access to the specified permissions. If there are any
problems removing the permissions, runtime.lastError will be set.
- * @param callback If you specify the callback parameter, it should be
a function that looks like this:
- * function(boolean removed) {...};
- * Parameter removed: True if the permissions were removed.
- */
- export function remove(permissions: Permissions, callback?: (removed:
boolean) => void): void;
-
- /** Fired when access to permissions has been removed from the
extension. */
- var onRemoved: PermissionsRemovedEvent;
- /** Fired when the extension acquires new permissions. */
- var onAdded: PermissionsAddedEvent;
-}
-
-////////////////////
-// Platform Keys
-////////////////////
-/**
- * Use the chrome.platformKeys API to access client certificates managed by
the platform. If the user or policy grants the permission, an extension can use
such a certficate in its custom authentication protocol. E.g. this allows usage
of platform managed certificates in third party VPNs (see chrome.vpnProvider).
- * Permissions: "platformKeys"
- * Important: This API works only on Chrome OS.
- * @since Chrome 45.
- */
-declare namespace chrome.platformKeys {
- interface Match {
- /** The DER encoding of a X.509 certificate. */
- certificate: ArrayBuffer;
- /** The KeyAlgorithm of the certified key. This contains
algorithm parameters that are inherent to the key of the certificate (e.g. the
key length). Other parameters like the hash function used by the sign function
are not included. */
- keyAlgorithm: KeyAlgorithm;
- }
-
- interface ClientCertificateSelectRequestDetails {
- /** This field is a list of the types of certificates
requested, sorted in order of the server's preference. Only certificates of a
type contained in this list will be retrieved. If certificateTypes is the empty
list, however, certificates of any type will be returned. */
- certificateTypes: string[];
- /** List of distinguished names of certificate authorities
allowed by the server. Each entry must be a DER-encoded X.509
DistinguishedName. */
- certificateAuthorities: ArrayBuffer[];
- }
-
- interface ClientCertificateSelectDetails {
- /** Only certificates that match this request will be returned.
*/
- request: ClientCertificateSelectRequestDetails;
- /**
- * Optional.
- * If given, the selectClientCertificates operates on this
list. Otherwise, obtains the list of all certificates from the platform's
certificate stores that are available to this extensions. Entries that the
extension doesn't have permission for or which doesn't match the request, are
removed.
- */
- clientCerts?: ArrayBuffer[];
- /** If true, the filtered list is presented to the user to
manually select a certificate and thereby granting the extension access to the
certificate(s) and key(s). Only the selected certificate(s) will be returned.
If is false, the list is reduced to all certificates that the extension has
been granted access to (automatically or manually). */
- interactive: boolean;
- }
-
- interface ServerCertificateVerificationDetails {
- /** Each chain entry must be the DER encoding of a X.509
certificate, the first entry must be the server certificate and each entry must
certify the entry preceding it. */
- serverCertificateChain: ArrayBuffer[];
- /** The hostname of the server to verify the certificate for,
e.g. the server that presented the serverCertificateChain. */
- hostname: string;
- }
-
- interface ServerCertificateVerificationResult {
- /** The result of the trust verification: true if trust for the
given verification details could be established and false if trust is rejected
for any reason. */
- trusted: boolean;
- /**
- * If the trust verification failed, this array contains the
errors reported by the underlying network layer. Otherwise, this array is empty.
- * Note: This list is meant for debugging only and may not
contain all relevant errors. The errors returned may change in future revisions
of this API, and are not guaranteed to be forwards or backwards compatible.
- */
- debug_errors: string[];
- }
-
- /**
- * This function filters from a list of client certificates the ones
that are known to the platform, match request and for which the extension has
permission to access the certificate and its private key. If interactive is
true, the user is presented a dialog where he can select from matching
certificates and grant the extension access to the certificate. The
selected/filtered client certificates will be passed to callback.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(array of Match matches) {...};
- * Parameter matches: The list of certificates that match the request,
that the extension has permission for and, if interactive is true, that were
selected by the user.
- */
- export function selectClientCertificates(details:
ClientCertificateSelectDetails, callback: (matches: Match[]) => void): void;
- /**
- * Passes the key pair of certificate for usage with
platformKeys.subtleCrypto to callback.
- * @param certificate The certificate of a Match returned by
selectClientCertificates.
- * @param parameters Determines signature/hash algorithm parameters
additionally to the parameters fixed by the key itself. The same parameters are
accepted as by WebCrypto's importKey function, e.g. RsaHashedImportParams for
a RSASSA-PKCS1-v1_5 key. For RSASSA-PKCS1-v1_5 keys, additionally the
parameters { 'hash': { 'name': 'none' } } are supported. The sign function will
then apply PKCS#1 v1.5 padding and but not hash the given data.
- * @param callback The public and private CryptoKey of a certificate
which can only be used with platformKeys.subtleCrypto.
- * The callback parameter should be a function that looks like this:
- * function(object publicKey, object privateKey) {...};
- * Optional parameter privateKey: Might be null if this extension does
not have access to it.
- */
- export function getKeyPair(certificate: ArrayBuffer, parameters:
Object, callback: (publicKey: CryptoKey, privateKey?: CryptoKey) => void): void;
- /** An implementation of WebCrypto's SubtleCrypto that allows crypto
operations on keys of client certificates that are available to this extension.
*/
- export function subtleCrypto(): SubtleCrypto;
- /**
- * Checks whether details.serverCertificateChain can be trusted for
details.hostname according to the trust settings of the platform. Note: The
actual behavior of the trust verification is not fully specified and might
change in the future. The API implementation verifies certificate expiration,
validates the certification path and checks trust by a known CA. The
implementation is supposed to respect the EKU serverAuth and to support subject
alternative names.
- * @param callback The callback parameter should be a function that
looks like this:
- * function(object result) {...};
- */
- export function verifyTLSServerCertificate(details:
ServerCertificateVerificationDetails, callback: (result:
ServerCertificateVerificationResult) => void): void;
-}
-
-////////////////////
-// Power
-////////////////////
-/**
- * Use the chrome.power API to override the system's power management features.
- * Permissions: "power"
- * @since Chrome 27.
- */
-declare namespace chrome.power {
- /** Requests that power management be temporarily disabled. |level|
describes the degree to which power management should be disabled. If a request
previously made by the same app is still active, it will be replaced by the new
request. */
- export function requestKeepAwake(level: string): void;
- /** Releases a request previously made via requestKeepAwake(). */
- export function releaseKeepAwake(): void;
-}
-
-////////////////////
-// Printer Provider
-////////////////////
-/**
- * The chrome.printerProvider API exposes events used by print manager to
query printers controlled by extensions, to query their capabilities and to
submit print jobs to these printers.
- * Permissions: "printerProvider"
- * @since Chrome 44.
- */
-declare namespace chrome.printerProvider {
- interface PrinterInfo {
- /** Unique printer ID. */
- id: string;
- /** Printer's human readable name. */
- name: string;
- /** Optional. Printer's human readable description. */
- description?: string;
- }
-
- interface PrinterCapabilities {
- /** Device capabilities in CDD format. */
- capabilities: any;
- }
-
- interface PrintJob {
- /** ID of the printer which should handle the job. */
- printerId: string;
- /** The print job title. */
- title: string;
- /** Print ticket in CJT format. */
- ticket: Object;
- /** The document content type. Supported formats are
"application/pdf" and "image/pwg-raster". */
- contentType: string;
- /** Blob containing the document data to print. Format must
match |contentType|. */
- document: Blob;
- }
-
- interface PrinterRequestedEvent extends
chrome.events.Event<(resultCallback: (printerInfo: PrinterInfo[]) => void) =>
void> {}
-
- interface PrinterInfoRequestedEvent extends
chrome.events.Event<(device: any, resultCallback: (printerInfo?: PrinterInfo)
=> void) => void> {}
-
- interface CapabilityRequestedEvent extends
chrome.events.Event<(printerId: string, resultCallback: (capabilities:
PrinterCapabilities) => void) => void> {}
-
- interface PrintRequestedEvent extends chrome.events.Event<(printJob:
PrintJob, resultCallback: (result: string) => void) => void> {}
-
- /** Event fired when print manager requests printers provided by
extensions. */
- export var onGetPrintersRequested: PrinterRequestedEvent;
- /**
- * Event fired when print manager requests information about a USB
device that may be a printer.
- * Note: An application should not rely on this event being fired more
than once per device. If a connected device is supported it should be returned
in the onGetPrintersRequested event.
- * @since Chrome 45.
- */
- export var onGetUsbPrinterInfoRequested: PrinterInfoRequestedEvent;
- /** Event fired when print manager requests printer capabilities. */
- export var onGetCapabilityRequested: CapabilityRequestedEvent;
- /** Event fired when print manager requests printing. */
- export var onPrintRequested: PrintRequestedEvent;
-}
-
-////////////////////
-// Privacy
-////////////////////
-/**
- * Use the chrome.privacy API to control usage of the features in Chrome that
can affect a user's privacy. This API relies on the ChromeSetting prototype of
the type API for getting and setting Chrome's configuration.
- * Permissions: "privacy"
- * The Chrome Privacy Whitepaper gives background detail regarding the
features which this API can control.
- * @since Chrome 18.
- */
-declare namespace chrome.privacy {
- interface Services {
- /** since Chrome 20. */
- spellingServiceEnabled: chrome.types.ChromeSetting;
- searchSuggestEnabled: chrome.types.ChromeSetting;
- instantEnabled: chrome.types.ChromeSetting;
- alternateErrorPagesEnabled: chrome.types.ChromeSetting;
- safeBrowsingEnabled: chrome.types.ChromeSetting;
- autofillEnabled: chrome.types.ChromeSetting;
- translationServiceEnabled: chrome.types.ChromeSetting;
- /** @since Chrome 38. */
- passwordSavingEnabled: chrome.types.ChromeSetting;
- /** @since Chrome 42. */
- hotwordSearchEnabled: chrome.types.ChromeSetting;
- /** @since Chrome 42. */
- safeBrowsingExtendedReportingEnabled:
chrome.types.ChromeSetting;
- }
-
- interface Network {
- networkPredictionEnabled: chrome.types.ChromeSetting;
- /** @since Chrome 42. */
- webRTCMultipleRoutesEnabled: chrome.types.ChromeSetting;
- /** @since Chrome 47. Warning: this is the current Dev channel.
*/
- webRTCNonProxiedUdpEnabled: chrome.types.ChromeSetting;
- }
-
- interface Websites {
- thirdPartyCookiesAllowed: chrome.types.ChromeSetting;
- referrersEnabled: chrome.types.ChromeSetting;
- hyperlinkAuditingEnabled: chrome.types.ChromeSetting;
- /** @since Chrome 21. */
- protectedContentEnabled: chrome.types.ChromeSetting;
- }
-
- /** Settings that enable or disable features that require third-party
network services provided by Google and your default search provider. */
- var services: Services;
- /** Settings that influence Chrome's handling of network connections in
general. */
- var network: Network;
- /** Settings that determine what information Chrome makes available to
websites. */
- var websites: Websites;
-}
-
-////////////////////
-// Proxy
-////////////////////
-/**
- * Use the chrome.proxy API to manage Chrome's proxy settings. This API relies
on the ChromeSetting prototype of the type API for getting and setting the
proxy configuration.
- * Permissions: "proxy"
- * @since Chrome 13.
- */
-declare namespace chrome.proxy {
- /** An object holding proxy auto-config information. Exactly one of the
fields should be non-empty. */
- interface PacScript {
- /** Optional. URL of the PAC file to be used. */
- url?: string;
- /** Optional. If true, an invalid PAC script will prevent the network
stack from falling back to direct connections. Defaults to false. */
- mandatory?: boolean;
- /** Optional. A PAC script. */
- data?: string;
- }
-
- /** An object encapsulating a complete proxy configuration. */
- interface ProxyConfig {
- /** Optional. The proxy rules describing this configuration. Use this
for 'fixed_servers' mode. */
- rules?: ProxyRules;
- /** Optional. The proxy auto-config (PAC) script for this
configuration. Use this for 'pac_script' mode. */
- pacScript?: PacScript;
- /**
- * 'direct' = Never use a proxy
- * 'auto_detect' = Auto detect proxy settings
- * 'pac_script' = Use specified PAC script
- * 'fixed_servers' = Manually specify proxy servers
- * 'system' = Use system proxy settings
- */
- mode: string;
- }
-
- /** An object encapsulating a single proxy server's specification. */
- interface ProxyServer {
- /** The URI of the proxy server. This must be an ASCII hostname (in
Punycode format). IDNA is not supported, yet. */
- host: string;
- /** Optional. The scheme (protocol) of the proxy server itself.
Defaults to 'http'. */
- scheme?: string;
- /** Optional. The port of the proxy server. Defaults to a port that
depends on the scheme. */
- port?: number;
- }
-
- /** An object encapsulating the set of proxy rules for all protocols. Use
either 'singleProxy' or (a subset of) 'proxyForHttp', 'proxyForHttps',
'proxyForFtp' and 'fallbackProxy'. */
- interface ProxyRules {
- /** Optional. The proxy server to be used for FTP requests. */
- proxyForFtp?: ProxyServer;
- /** Optional. The proxy server to be used for HTTP requests. */
- proxyForHttp?: ProxyServer;
- /** Optional. The proxy server to be used for everthing else or if any
of the specific proxyFor... is not specified. */
- fallbackProxy?: ProxyServer;
- /** Optional. The proxy server to be used for all per-URL requests
(that is http, https, and ftp). */
- singleProxy?: ProxyServer;
- /** Optional. The proxy server to be used for HTTPS requests. */
- proxyForHttps?: ProxyServer;
- /** Optional. List of servers to connect to without a proxy server. */
- bypassList?: string[];
- }
-
- interface ErrorDetails {
- /** Additional details about the error such as a JavaScript runtime
error. */
- details: string;
- /** The error description. */
- error: string;
- /** If true, the error was fatal and the network transaction was
aborted. Otherwise, a direct connection is used instead. */
- fatal: boolean;
- }
-
- interface ProxyErrorEvent extends chrome.events.Event<(details:
ErrorDetails) => void> {}
-
- var settings: chrome.types.ChromeSetting;
- /** Notifies about proxy errors. */
- var onProxyError: ProxyErrorEvent;
-}
-
-////////////////////
-// Runtime
-////////////////////
-/**
- * Use the chrome.runtime API to retrieve the background page, return details
about the manifest, and listen for and respond to events in the app or
extension lifecycle. You can also use this API to convert the relative path of
URLs to fully-qualified URLs.
- * @since Chrome 22
- */
-declare namespace chrome.runtime {
- /** This will be defined during an API method callback if there was an
error */
- var lastError: LastError;
- /** The ID of the extension/app. */
- var id: string;
-
- interface LastError {
- /** Optional. Details about the error which occurred. */
- message?: string;
- }
-
- interface ConnectInfo {
- name?: string;
- }
-
- interface InstalledDetails {
- /**
- * The reason that this event is being dispatched.
- * One of: "install", "update", "chrome_update", or
"shared_module_update"
- */
- reason: string;
- /**
- * Optional.
- * Indicates the previous version of the extension, which has
just been updated. This is present only if 'reason' is 'update'.
- */
- previousVersion?: string;
- /**
- * Optional.
- * Indicates the ID of the imported shared module extension
which updated. This is present only if 'reason' is 'shared_module_update'.
- * @since Chrome 29.
- */
- id?: string;
- }
-
- interface MessageOptions {
- /** Whether the TLS channel ID will be passed into onMessageExternal
for processes that are listening for the connection event. */
- includeTlsChannelId?: boolean;
- }
-
- /**
- * An object containing information about the script context that sent a
message or request.
- * @since Chrome 26.
- */
- interface MessageSender {
- /** The ID of the extension or app that opened the connection, if any.
*/
- id?: string;
- /** The tabs.Tab which opened the connection, if any. This property
will only be present when the connection was opened from a tab (including
content scripts), and only if the receiver is an extension, not an app. */
- tab?: chrome.tabs.Tab;
- /**
- * The frame that opened the connection. 0 for top-level frames,
positive for child frames. This will only be set when tab is set.
- * @since Chrome 41.
- */
- frameId?: number;
- /**
- * The URL of the page or frame that opened the connection. If the
sender is in an iframe, it will be iframe's URL not the URL of the page which
hosts it.
- * @since Chrome 28.
- */
- url?: string;
- /**
- * The TLS channel ID of the page or frame that opened the connection,
if requested by the extension or app, and if available.
- * @since Chrome 32.
- */
- tlsChannelId?: string;
- }
-
- /**
- * An object containing information about the current platform.
- * @since Chrome 36.
- */
- interface PlatformInfo {
- /**
- * The operating system chrome is running on.
- * One of: "mac", "win", "android", "cros", "linux", or "openbsd"
- */
- os: string;
- /**
- * The machine's processor architecture.
- * One of: "arm", "x86-32", or "x86-64"
- */
- arch: string;
- /**
- * The native client architecture. This may be different from arch on
some platforms.
- * One of: "arm", "x86-32", or "x86-64"
- */
- nacl_arch: string;
- }
-
- /**
- * An object which allows two way communication with other pages.
- * @since Chrome 26.
- */
- interface Port {
- postMessage: (message: Object) => void;
- disconnect: () => void;
- /**
- * Optional.
- * This property will only be present on ports passed to
onConnect/onConnectExternal listeners.
- */
- sender?: MessageSender;
- /** An object which allows the addition and removal of listeners for a
Chrome event. */
- onDisconnect: chrome.events.Event<() => void>;
- /** An object which allows the addition and removal of listeners for a
Chrome event. */
- onMessage: PortMessageEvent;
- name: string;
- }
-
- interface UpdateAvailableDetails {
- /** The version number of the available update. */
- version: string;
- }
-
- interface UpdateCheckDetails {
- /** The version of the available update. */
- version: string;
- }
-
- interface PortMessageEvent extends chrome.events.Event<(message: Object,
port: Port) => void> {}
-
- interface ExtensionMessageEvent extends chrome.events.Event<(message: any,
sender: MessageSender, sendResponse: (response: any) => void) => void> {}
-
- interface ExtensionConnectEvent extends chrome.events.Event<(port: Port)
=> void> {}
-
- interface RuntimeInstalledEvent extends chrome.events.Event<(details:
InstalledDetails) => void> {}
-
- interface RuntimeEvent extends chrome.events.Event<() => void> {}
-
- interface RuntimeRestartRequiredEvent extends chrome.events.Event<(reason:
string) => void> {}
-
- interface RuntimeUpdateAvailableEvent extends
chrome.events.Event<(details: UpdateAvailableDetails) => void> {}
-
- interface ManifestIcons {
- [size: number]: string;
- }
-
- interface ManifestAction {
- default_icon?: ManifestIcons;
- default_title?: string;
- default_popup?: string;
- }
-
- interface SearchProvider {
- name?: string;
- keyword?: string;
- favicon_url?: string;
- search_url: string;
- encoding?: string;
- suggest_url?: string;
- instant_url?: string;
- image_url?: string;
- search_url_post_params?: string;
- suggest_url_post_params?: string;
- instant_url_post_params?: string;
- image_url_post_params?: string;
- alternate_urls?: string[];
- prepopulated_id?: number;
- is_default?: boolean;
- }
-
- interface Manifest {
- // Required
- manifest_version: number;
- name: string;
- version: string;
-
- // Recommended
- default_locale?: string;
- description?: string;
- icons?: ManifestIcons;
-
- // Pick one (or none)
- browser_action?: ManifestAction;
- page_action?: ManifestAction;
-
- // Optional
- author?: any;
- automation?: any;
- background?: {
- scripts?: string[];
- page?: string;
- persistent?: boolean;
- };
- background_page?: string;
- chrome_settings_overrides?: {
- homepage?: string;
- search_provider?: SearchProvider;
- startup_pages?: string[];
- };
- chrome_ui_overrides?: {
- bookmarks_ui?: {
- remove_bookmark_shortcut?: boolean;
- remove_button?: boolean;
- }
- };
- chrome_url_overrides?: {
- bookmarks?: string;
- history?: string;
- newtab?: string;
- };
- commands?: {
- [name: string]: {
- suggested_key?: {
- default?: string;
- windows?: string;
- mac?: string;
- chromeos?: string;
- linux?: string;
- };
- description?: string;
- global?: boolean
- }
- };
- content_capabilities?: {
- matches?: string[];
- permissions?: string[];
- };
- content_scripts?: {
- matches?: string[];
- exclude_matches?: string[];
- css?: string[];
- js?: string[];
- run_at?: string;
- all_frames?: boolean;
- include_globs?: string[];
- exclude_globs?: string[];
- }[];
- content_security_policy?: string;
- converted_from_user_script?: boolean;
- copresence?: any;
- current_locale?: string;
- devtools_page?: string;
- event_rules?: {
- event?: string;
- actions?: {
- type: string;
- }[];
- conditions?: chrome.declarativeContent.PageStateMatcher[]
- }[];
- externally_connectable?: {
- ids?: string[];
- matches?: string[];
- accepts_tls_channel_id?: boolean;
- };
- file_browser_handlers?: {
- id?: string;
- default_title?: string;
- file_filters?: string[];
- }[];
- file_system_provider_capabilities?: {
- configurable?: boolean;
- watchable?: boolean;
- multiple_mounts?: boolean;
- source?: string;
- };
- homepage_url?: string;
- import?: {
- id: string;
- minimum_version?: string
- }[];
- export?: {
- whitelist?: string[]
- };
- incognito?: string;
- input_components?: {
- name?: string;
- type?: string;
- id?: string;
- description?: string;
- language?: string;
- layouts?: any[];
- }[];
- key?: string;
- minimum_chrome_version?: string;
- nacl_modules?: {
- path: string;
- mime_type: string;
- }[];
- oauth2?: {
- client_id: string;
- scopes?: string[];
- };
- offline_enabled?: boolean;
- omnibox?: {
- keyword: string;
- };
- optional_permissions?: string[];
- options_page?: string;
- options_ui?: {
- page?: string;
- chrome_style?: boolean;
- open_in_tab?: boolean;
- };
- permissions?: string[];
- platforms?: {
- nacl_arch?: string;
- sub_package_path: string;
- }[];
- plugins?: {
- path: string;
- }[];
- requirements?: {
- '3D'?: {
- features?: string[]
- };
- plugins?: {
- npapi?: boolean;
- }
- };
- sandbox?: {
- pages: string[];
- content_security_policy?: string;
- };
- short_name?: string;
- signature?: any;
- spellcheck?: {
- dictionary_language?: string;
- dictionary_locale?: string;
- dictionary_format?: string;
- dictionary_path?: string;
- };
- storage?: {
- managed_schema: string
- };
- system_indicator?: any;
- tts_engine?: {
- voices: {
- voice_name: string;
- lang?: string;
- gender?: string;
- event_types?: string[];
- }[]
- };
- update_url?: string;
- version_name?: string;
- web_accessible_resources?: string[];
- [key: string]: any;
- }
-
- /**
- * Attempts to connect to connect listeners within an extension/app (such
as the background page), or other extensions/apps. This is useful for content
scripts connecting to their extension processes, inter-app/extension
communication, and web messaging. Note that this does not connect to any
listeners in a content script. Extensions may connect to content scripts
embedded in tabs via tabs.connect.
- * @since Chrome 26.
- */
- export function connect(connectInfo?: ConnectInfo): Port;
- /**
- * Attempts to connect to connect listeners within an extension/app (such
as the background page), or other extensions/apps. This is useful for content
scripts connecting to their extension processes, inter-app/extension
communication, and web messaging. Note that this does not connect to any
listeners in a content script. Extensions may connect to content scripts
embedded in tabs via tabs.connect.
- * @since Chrome 26.
- * @param extensionId Optional.
- * The ID of the extension or app to connect to. If omitted, a connection
will be attempted with your own extension. Required if sending messages from a
web page for web messaging.
- */
- export function connect(extensionId: string, connectInfo?: ConnectInfo):
Port;
- /**
- * Connects to a native application in the host machine.
- * @since Chrome 28.
- * @param application The name of the registered application to connect to.
- */
- export function connectNative(application: string): Port;
- /** Retrieves the JavaScript 'window' object for the background page
running inside the current extension/app. If the background page is an event
page, the system will ensure it is loaded before calling the callback. If there
is no background page, an error is set. */
- export function getBackgroundPage(callback: (backgroundPage?: Window) =>
void): void;
- /**
- * Returns details about the app or extension from the manifest. The
object returned is a serialization of the full manifest file.
- * @returns The manifest details.
- */
- export function getManifest(): Manifest;
- /**
- * Returns a DirectoryEntry for the package directory.
- * @since Chrome 29.
- */
- export function getPackageDirectoryEntry(callback: (directoryEntry:
DirectoryEntry) => void): void;
- /**
- * Returns information about the current platform.
- * @since Chrome 29.
- * @param callback Called with results
- */
- export function getPlatformInfo(callback: (platformInfo: PlatformInfo) =>
void): void;
- /**
- * Converts a relative path within an app/extension install directory to a
fully-qualified URL.
- * @param path A path to a resource within an app/extension expressed
relative to its install directory.
- */
- export function getURL(path: string): string;
- /**
- * Reloads the app or extension.
- * @since Chrome 25.
- */
- export function reload(): void;
- /**
- * Requests an update check for this app/extension.
- * @since Chrome 25.
- * @param callback
- * Parameter status: Result of the update check. One of: "throttled",
"no_update", or "update_available"
- * Optional parameter details: If an update is available, this contains
more information about the available update.
- */
- export function requestUpdateCheck(callback: (status: string, details?:
UpdateCheckDetails) => void): void;
- /**
- * Restart the ChromeOS device when the app runs in kiosk mode. Otherwise,
it's no-op.
- * @since Chrome 32.
- */
- export function restart(): void;
- /**
- * Sends a single message to event listeners within your extension/app or
a different extension/app. Similar to runtime.connect but only sends a single
message, with an optional response. If sending to your extension, the
runtime.onMessage event will be fired in each page, or
runtime.onMessageExternal, if a different extension. Note that extensions
cannot send messages to content scripts using this method. To send messages to
content scripts, use tabs.sendMessage.
- * @since Chrome 26.
- * @param responseCallback Optional
- * Parameter response: The JSON response object sent by the handler of the
message. If an error occurs while connecting to the extension, the callback
will be called with no arguments and runtime.lastError will be set to the error
message.
- */
- export function sendMessage(message: any, responseCallback?: (response:
any) => void): void;
- /**
- * Sends a single message to event listeners within your extension/app or
a different extension/app. Similar to runtime.connect but only sends a single
message, with an optional response. If sending to your extension, the
runtime.onMessage event will be fired in each page, or
runtime.onMessageExternal, if a different extension. Note that extensions
cannot send messages to content scripts using this method. To send messages to
content scripts, use tabs.sendMessage.
- * @since Chrome 32.
- * @param responseCallback Optional
- * Parameter response: The JSON response object sent by the handler of the
message. If an error occurs while connecting to the extension, the callback
will be called with no arguments and runtime.lastError will be set to the error
message.
- */
- export function sendMessage(message: any, options: MessageOptions,
responseCallback?: (response: any) => void): void;
- /**
- * Sends a single message to event listeners within your extension/app or
a different extension/app. Similar to runtime.connect but only sends a single
message, with an optional response. If sending to your extension, the
runtime.onMessage event will be fired in each page, or
runtime.onMessageExternal, if a different extension. Note that extensions
cannot send messages to content scripts using this method. To send messages to
content scripts, use tabs.sendMessage.
- * @since Chrome 26.
- * @param extensionId The ID of the extension/app to send the message to.
If omitted, the message will be sent to your own extension/app. Required if
sending messages from a web page for web messaging.
- * @param responseCallback Optional
- * Parameter response: The JSON response object sent by the handler of the
message. If an error occurs while connecting to the extension, the callback
will be called with no arguments and runtime.lastError will be set to the error
message.
- */
- export function sendMessage(extensionId: string, message: any,
responseCallback?: (response: any) => void): void;
- /**
- * Sends a single message to event listeners within your extension/app or
a different extension/app. Similar to runtime.connect but only sends a single
message, with an optional response. If sending to your extension, the
runtime.onMessage event will be fired in each page, or
runtime.onMessageExternal, if a different extension. Note that extensions
cannot send messages to content scripts using this method. To send messages to
content scripts, use tabs.sendMessage.
- * @since Chrome 32.
- * @param extensionId The ID of the extension/app to send the message to.
If omitted, the message will be sent to your own extension/app. Required if
sending messages from a web page for web messaging.
- * @param responseCallback Optional
- * Parameter response: The JSON response object sent by the handler of the
message. If an error occurs while connecting to the extension, the callback
will be called with no arguments and runtime.lastError will be set to the error
message.
- */
- export function sendMessage(extensionId: string, message: any, options:
MessageOptions, responseCallback?: (response: any) => void): void;
- /**
- * Send a single message to a native application.
- * @since Chrome 28.
- * @param application The of the native messaging host.
- * @param message The message that will be passed to the native messaging
host.
- * @param responseCallback Optional.
- * Parameter response: The response message sent by the native messaging
host. If an error occurs while connecting to the native messaging host, the
callback will be called with no arguments and runtime.lastError will be set to
the error message.
- */
- export function sendNativeMessage(application: string, message: Object,
responseCallback?: (response: any) => void): void;
- /**
- * Sets the URL to be visited upon uninstallation. This may be used to
clean up server-side data, do analytics, and implement surveys. Maximum 255
characters.
- * @since Chrome 41.
- * @param url Since Chrome 34.
- * URL to be opened after the extension is uninstalled. This URL must have
an http: or https: scheme. Set an empty string to not open a new tab upon
uninstallation.
- * @param callback Called when the uninstall URL is set. If the given URL
is invalid, runtime.lastError will be set.
- */
- export function setUninstallURL(url: string, callback?: () => void):
void;
- /**
- * Open your Extension's options page, if possible.
- * The precise behavior may depend on your manifest's options_ui or
options_page key, or what Chrome happens to support at the time. For example,
the page may be opened in a new tab, within chrome://extensions, within an App,
or it may just focus an open options page. It will never cause the caller page
to reload.
- * If your Extension does not declare an options page, or Chrome failed to
create one for some other reason, the callback will set lastError.
- * @since Chrome 42.
- */
- export function openOptionsPage(callback?: () => void): void;
-
- /**
- * Fired when a connection is made from either an extension process or
a content script.
- * @since Chrome 26.
- */
- var onConnect: ExtensionConnectEvent;
- /**
- * Fired when a connection is made from another extension.
- * @since Chrome 26.
- */
- var onConnectExternal: ExtensionConnectEvent;
- /** Sent to the event page just before it is unloaded. This gives the
extension opportunity to do some clean up. Note that since the page is
unloading, any asynchronous operations started while handling this event are
not guaranteed to complete. If more activity for the event page occurs before
it gets unloaded the onSuspendCanceled event will be sent and the page won't be
unloaded. */
- var onSuspend: RuntimeEvent;
- /**
- * Fired when a profile that has this extension installed first starts
up. This event is not fired when an incognito profile is started, even if this
extension is operating in 'split' incognito mode.
- * @since Chrome 23.
- */
- var onStartup: RuntimeEvent;
- /** Fired when the extension is first installed, when the extension is
updated to a new version, and when Chrome is updated to a new version. */
- var onInstalled: RuntimeInstalledEvent;
- /** Sent after onSuspend to indicate that the app won't be unloaded
after all. */
- var onSuspendCanceled: RuntimeEvent;
- /**
- * Fired when a message is sent from either an extension process or a
content script.
- * @since Chrome 26.
- */
- var onMessage: ExtensionMessageEvent;
- /**
- * Fired when a message is sent from another extension/app. Cannot be
used in a content script.
- * @since Chrome 26.
- */
- var onMessageExternal: ExtensionMessageEvent;
- /**
- * Fired when an app or the device that it runs on needs to be
restarted. The app should close all its windows at its earliest convenient time
to let the restart to happen. If the app does nothing, a restart will be
enforced after a 24-hour grace period has passed. Currently, this event is only
fired for Chrome OS kiosk apps.
- * @since Chrome 29.
- */
- var onRestartRequired: RuntimeRestartRequiredEvent;
- /**
- * Fired when an update is available, but isn't installed immediately
because the app is currently running. If you do nothing, the update will be
installed the next time the background page gets unloaded, if you want it to be
installed sooner you can explicitly call chrome.runtime.reload(). If your
extension is using a persistent background page, the background page of course
never gets unloaded, so unless you call chrome.runtime.reload() manually in
response to this event the update wi [...]
- * @since Chrome 25.
- */
- var onUpdateAvailable: RuntimeUpdateAvailableEvent;
- /**
- * @deprecated since Chrome 33. Please use
chrome.runtime.onRestartRequired.
- * Fired when a Chrome update is available, but isn't installed
immediately because a browser restart is required.
- */
- var onBrowserUpdateAvailable: RuntimeEvent;
-}
-
-////////////////////
-// Script Badge
-////////////////////
-declare namespace chrome.scriptBadge {
- interface GetPopupDetails {
- tabId: number;
- }
-
- interface AttentionDetails {
- tabId: number;
- }
-
- interface SetPopupDetails {
- tabId: number;
- popup: string;
- }
-
- interface ScriptBadgeClickedEvent extends chrome.events.Event<(tab:
chrome.tabs.Tab) => void> {}
-
- export function getPopup(details: GetPopupDetails, callback: Function):
void;
- export function getAttention(details: AttentionDetails): void;
- export function setPopup(details: SetPopupDetails): void;
-
- var onClicked: ScriptBadgeClickedEvent;
-}
-
-////////////////////
-// Sessions
-////////////////////
-/**
- * Use the chrome.sessions API to query and restore tabs and windows from a
browsing session.
- * Permissions: "sessions"
- * @since Chrome 37.
- */
-declare namespace chrome.sessions {
- interface Filter {
- /**
- * Optional.
- * The maximum number of entries to be fetched in the requested
list. Omit this parameter to fetch the maximum number of entries
(sessions.MAX_SESSION_RESULTS).
- */
- maxResults?: number;
- }
-
- interface Session {
- /** The time when the window or tab was closed or modified,
represented in milliseconds since the epoch. */
- lastModified: number;
- /**
- * Optional.
- * The tabs.Tab, if this entry describes a tab. Either this or
sessions.Session.window will be set.
- */
- tab?: tabs.Tab;
- /**
- * Optional.
- * The windows.Window, if this entry describes a window. Either
this or sessions.Session.tab will be set.
- */
- window?: windows.Window;
- }
-
- interface Device {
- /** The name of the foreign device. */
- deviceName: string;
- /** A list of open window sessions for the foreign device,
sorted from most recently to least recently modified session. */
- sessions: Session[];
- }
-
- interface SessionChangedEvent extends chrome.events.Event<() => void> {}
-
- /** The maximum number of sessions.Session that will be included in a
requested list. */
- export var MAX_SESSION_RESULTS: number;
-
- /**
- * Gets the list of recently closed tabs and/or windows.
- * @param callback
- * Parameter sessions: The list of closed entries in reverse order that
they were closed (the most recently closed tab or window will be at index 0).
The entries may contain either tabs or windows.
- */
- export function getRecentlyClosed(filter: Filter, callback: (sessions:
Session[]) => void): void;
- /**
- * Gets the list of recently closed tabs and/or windows.
- * @param callback
- * Parameter sessions: The list of closed entries in reverse order that
they were closed (the most recently closed tab or window will be at index 0).
The entries may contain either tabs or windows.
- */
- export function getRecentlyClosed(callback: (sessions: Session[]) =>
void): void;
- /**
- * Retrieves all devices with synced sessions.
- * @param callback
- * Parameter devices: The list of sessions.Device objects for each
synced session, sorted in order from device with most recently modified session
to device with least recently modified session. tabs.Tab objects are sorted by
recency in the windows.Window of the sessions.Session objects.
- */
- export function getDevices(filter: Filter, callback: (devices:
Device[]) => void): void;
- /**
- * Retrieves all devices with synced sessions.
- * @param callback
- * Parameter devices: The list of sessions.Device objects for each
synced session, sorted in order from device with most recently modified session
to device with least recently modified session. tabs.Tab objects are sorted by
recency in the windows.Window of the sessions.Session objects.
- */
- export function getDevices(callback: (devices: Device[]) => void): void;
- /**
- * Reopens a windows.Window or tabs.Tab, with an optional callback to
run when the entry has been restored.
- * @param sessionId Optional.
- * The windows.Window.sessionId, or tabs.Tab.sessionId to restore. If
this parameter is not specified, the most recently closed session is restored.
- * @param callback Optional.
- * Parameter restoredSession: A sessions.Session containing the
restored windows.Window or tabs.Tab object.
- */
- export function restore(sessionId?: string, callback?:
(restoredSession: Session) => void): void;
-
- /** Fired when recently closed tabs and/or windows are changed. This
event does not monitor synced sessions changes. */
- export var onChanged: SessionChangedEvent;
-}
-
-////////////////////
-// Storage
-////////////////////
-/**
- * Use the chrome.storage API to store, retrieve, and track changes to user
data.
- * Permissions: "storage"
- * @since Chrome 20.
- */
-declare namespace chrome.storage {
- interface StorageArea {
- /**
- * Gets the amount of space (in bytes) being used by one or
more items.
- * @param callback Callback with the amount of space being used
by storage, or on failure (in which case runtime.lastError will be set).
- * Parameter bytesInUse: Amount of space being used in storage,
in bytes.
- */
- getBytesInUse(callback: (bytesInUse: number) => void): void;
- /**
- * Gets the amount of space (in bytes) being used by one or
more items.
- * @param key A single key to get the total usage for. Pass in
null to get the total usage of all of storage.
- * @param callback Callback with the amount of space being used
by storage, or on failure (in which case runtime.lastError will be set).
- * Parameter bytesInUse: Amount of space being used in storage,
in bytes.
- */
- getBytesInUse(key: string, callback: (bytesInUse: number) =>
void): void;
- /**
- * Gets the amount of space (in bytes) being used by one or
more items.
- * @param keys A list of keys to get the total usage for. An
empty list will return 0. Pass in null to get the total usage of all of storage.
- * @param callback Callback with the amount of space being used
by storage, or on failure (in which case runtime.lastError will be set).
- * Parameter bytesInUse: Amount of space being used in storage,
in bytes.
- */
- getBytesInUse(keys: string[], callback: (bytesInUse: number) =>
void): void;
- /**
- * Removes all items from storage.
- * @param callback Optional.
- * Callback on success, or on failure (in which case
runtime.lastError will be set).
- */
- clear(callback?: () => void): void;
- /**
- * Sets multiple items.
- * @param items An object which gives each key/value pair to
update storage with. Any other key/value pairs in storage will not be affected.
- * Primitive values such as numbers will serialize as expected.
Values with a typeof "object" and "function" will typically serialize to {},
with the exception of Array (serializes as expected), Date, and Regex
(serialize using their String representation).
- * @param callback Optional.
- * Callback on success, or on failure (in which case
runtime.lastError will be set).
- */
- set(items: Object, callback?: () => void): void;
- /**
- * Removes one item from storage.
- * @param key A single key for items to remove.
- * @param callback Optional.
- * Callback on success, or on failure (in which case
runtime.lastError will be set).
- */
- remove(key: string, callback?: () => void): void;
- /**
- * Removes items from storage.
- * @param keys A list of keys for items to remove.
- * @param callback Optional.
- * Callback on success, or on failure (in which case
runtime.lastError will be set).
- */
- remove(keys: string[], callback?: () => void): void;
- /**
- * Gets one or more items from storage.
- * @param callback Callback with storage items, or on failure
(in which case runtime.lastError will be set).
- * Parameter items: Object with items in their key-value
mappings.
- */
- get(callback: (items: { [key: string]: any }) => void): void;
- /**
- * Gets one or more items from storage.
- * @param key A single key to get. Pass in null to get the
entire contents of storage.
- * @param callback Callback with storage items, or on failure
(in which case runtime.lastError will be set).
- * Parameter items: Object with items in their key-value
mappings.
- */
- get(key: string, callback: (items: { [key: string]: any }) =>
void): void;
- /**
- * Gets one or more items from storage.
- * @param keys A list of keys to get. An empty list or object
will return an empty result object. Pass in null to get the entire contents of
storage.
- * @param callback Callback with storage items, or on failure
(in which case runtime.lastError will be set).
- * Parameter items: Object with items in their key-value
mappings.
- */
- get(keys: string[], callback: (items: { [key: string]: any })
=> void): void;
- /**
- * Gets one or more items from storage.
- * @param keys A dictionary specifying default values. Pass in
null to get the entire contents of storage.
- * @param callback Callback with storage items, or on failure
(in which case runtime.lastError will be set).
- * Parameter items: Object with items in their key-value
mappings.
- */
- get(keys: Object, callback: (items: { [key: string]: any }) =>
void): void;
- }
-
- interface StorageChange {
- /** Optional. The new value of the item, if there is a new
value. */
- newValue?: any;
- /** Optional. The old value of the item, if there was an old
value. */
- oldValue?: any;
- }
-
- interface LocalStorageArea extends StorageArea {
- /** The maximum amount (in bytes) of data that can be stored in
local storage, as measured by the JSON stringification of every value plus
every key's length. This value will be ignored if the extension has the
unlimitedStorage permission. Updates that would cause this limit to be exceeded
fail immediately and set runtime.lastError. */
- QUOTA_BYTES: number;
- }
-
- interface SyncStorageArea extends StorageArea {
- /** @deprecated since Chrome 40. The storage.sync API no longer
has a sustained write operation quota. */
- MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE: number;
- /** The maximum total amount (in bytes) of data that can be
stored in sync storage, as measured by the JSON stringification of every value
plus every key's length. Updates that would cause this limit to be exceeded
fail immediately and set runtime.lastError. */
- QUOTA_BYTES: number;
- /** The maximum size (in bytes) of each individual item in sync
storage, as measured by the JSON stringification of its value plus its key
length. Updates containing items larger than this limit will fail immediately
and set runtime.lastError. */
- QUOTA_BYTES_PER_ITEM: number;
- /** The maximum number of items that can be stored in sync
storage. Updates that would cause this limit to be exceeded will fail
immediately and set runtime.lastError. */
- MAX_ITEMS: number;
- /**
- * The maximum number of set, remove, or clear operations that
can be performed each hour. This is 1 every 2 seconds, a lower ceiling than the
short term higher writes-per-minute limit.
- * Updates that would cause this limit to be exceeded fail
immediately and set runtime.lastError.
- */
- MAX_WRITE_OPERATIONS_PER_HOUR: number;
- /**
- * The maximum number of set, remove, or clear operations that
can be performed each minute. This is 2 per second, providing higher throughput
than writes-per-hour over a shorter period of time.
- * Updates that would cause this limit to be exceeded fail
immediately and set runtime.lastError.
- * @since Chrome 40.
- */
- MAX_WRITE_OPERATIONS_PER_MINUTE: number;
- }
-
- interface StorageChangedEvent extends chrome.events.Event<(changes: {
[key: string]: StorageChange }, areaName: string) => void> {}
-
- /** Items in the local storage area are local to each machine. */
- var local: LocalStorageArea;
- /** Items in the sync storage area are synced using Chrome Sync. */
- var sync: SyncStorageArea;
-
- /**
- * Items in the managed storage area are set by the domain
administrator, and are read-only for the extension; trying to modify this
namespace results in an error.
- * @since Chrome 33.
- */
- var managed: StorageArea;
-
- /** Fired when one or more items change. */
- var onChanged: StorageChangedEvent;
-}
-
-////////////////////
-// Socket
-////////////////////
-declare namespace chrome.socket {
- interface CreateInfo {
- socketId: number;
- }
-
- interface AcceptInfo {
- resultCode: number;
- socketId?: number;
- }
-
- interface ReadInfo {
- resultCode: number;
- data: ArrayBuffer;
- }
-
- interface WriteInfo {
- bytesWritten: number;
- }
-
- interface RecvFromInfo {
- resultCode: number;
- data: ArrayBuffer;
- port: number;
- address: string;
- }
-
- interface SocketInfo {
- socketType: string;
- localPort?: number;
- peerAddress?: string;
- peerPort?: number;
- localAddress?: string;
- connected: boolean;
- }
-
- interface NetworkInterface {
- name: string;
- address: string;
- }
-
- export function create(type: string, options?: Object, callback?:
(createInfo: CreateInfo) => void): void;
- export function destroy(socketId: number): void;
- export function connect(socketId: number, hostname: string, port: number,
callback: (result: number) => void): void;
- export function bind(socketId: number, address: string, port: number,
callback: (result: number) => void): void;
- export function disconnect(socketId: number): void;
- export function read(socketId: number, bufferSize?: number, callback?:
(readInfo: ReadInfo) => void): void;
- export function write(socketId: number, data: ArrayBuffer, callback?:
(writeInfo: WriteInfo) => void): void;
- export function recvFrom(socketId: number, bufferSize?: number, callback?:
(recvFromInfo: RecvFromInfo) => void): void;
- export function sendTo(socketId: number, data: ArrayBuffer, address:
string, port: number, callback?: (writeInfo: WriteInfo) => void): void;
- export function listen(socketId: number, address: string, port: number,
backlog?: number, callback?: (result: number) => void): void;
- export function accept(socketId: number, callback?: (acceptInfo:
AcceptInfo) => void): void;
- export function setKeepAlive(socketId: number, enable: boolean, delay?:
number, callback?: (result: boolean) => void): void;
- export function setNoDelay(socketId: number, noDelay: boolean, callback?:
(result: boolean) => void): void;
- export function getInfo(socketId: number, callback: (result: SocketInfo)
=> void): void;
- export function getNetworkList(callback: (result: NetworkInterface[]) =>
void): void;
-}
-
-////////////////////
-// System CPU
-////////////////////
-/**
- * Use the system.cpu API to query CPU metadata.
- * Permissions: "system.cpu"
- * @since Chrome 32.
- */
-declare namespace chrome.system.cpu {
- interface ProcessorUsage {
- /** The cumulative time used by userspace programs on this
processor. */
- user: number;
- /** The cumulative time used by kernel programs on this
processor. */
- kernel: number;
- /** The cumulative time spent idle by this processor. */
- idle: number;
- /** The total cumulative time for this processor. This value is
equal to user + kernel + idle. */
- total: number;
- }
-
- interface ProcessorInfo {
- /** Cumulative usage info for this logical processor. */
- usage: ProcessorUsage;
- }
-
- interface CpuInfo {
- /** The number of logical processors. */
- numOfProcessors: number;
- /** The architecture name of the processors. */
- archName: string;
- /** The model name of the processors. */
- modelName: string;
- /**
- * A set of feature codes indicating some of the processor's
capabilities.
- * The currently supported codes are "mmx", "sse", "sse2",
"sse3", "ssse3", "sse4_1", "sse4_2", and "avx".
- */
- features: string[];
- /** Information about each logical processor. */
- processors: ProcessorInfo[];
- }
-
- /** Queries basic CPU information of the system. */
- export function getInfo(callback: (info: CpuInfo) => void): void;
-}
-
-////////////////////
-// System Memory
-////////////////////
-/**
- * The chrome.system.memory API.
- * Permissions: "system.memory"
- * @since Chrome 32.
- */
-declare namespace chrome.system.memory {
- interface MemoryInfo {
- /** The total amount of physical memory capacity, in bytes. */
- capacity: number;
- /** The amount of available capacity, in bytes. */
- availableCapacity: number;
- }
-
- /** Get physical memory information. */
- export function getInfo(callback: (info: MemoryInfo) => void): void;
-}
-
-////////////////////
-// System Storage
-////////////////////
-/**
- * Use the chrome.system.storage API to query storage device information and
be notified when a removable storage device is attached and detached.
- * Permissions: "system.storage"
- * @since Chrome 30.
- */
-declare namespace chrome.system.storage {
- interface StorageUnitInfo {
- /** The transient ID that uniquely identifies the storage
device. This ID will be persistent within the same run of a single application.
It will not be a persistent identifier between different runs of an
application, or between different applications. */
- id: string;
- /** The name of the storage unit. */
- name: string;
- /**
- * The media type of the storage unit.
- * fixed: The storage has fixed media, e.g. hard disk or SSD.
- * removable: The storage is removable, e.g. USB flash drive.
- * unknown: The storage type is unknown.
- */
- type: string;
- /** The total amount of the storage space, in bytes. */
- capacity: number;
- }
-
- interface StorageCapacityInfo {
- /** A copied |id| of getAvailableCapacity function parameter
|id|. */
- id: string;
- /** The available capacity of the storage device, in bytes. */
- availableCapacity: number;
- }
-
- interface SystemStorageAttachedEvent extends chrome.events.Event<(info:
StorageUnitInfo) => void> {}
-
- interface SystemStorageDetachedEvent extends chrome.events.Event<(id:
string) => void> {}
-
- /** Get the storage information from the system. The argument passed to
the callback is an array of StorageUnitInfo objects. */
- export function getInfo(callback: (info: StorageUnitInfo[]) => void):
void;
- /**
- * Ejects a removable storage device.
- * @param callback
- * Parameter result: success: The ejection command is successful -- the
application can prompt the user to remove the device; in_use: The device is in
use by another application. The ejection did not succeed; the user should not
remove the device until the other application is done with the device;
no_such_device: There is no such device known. failure: The ejection command
failed.
- */
- export function ejectDevice(id: string, callback: (result: string) =>
void): void;
- /**
- * Get the available capacity of a specified |id| storage device. The
|id| is the transient device ID from StorageUnitInfo.
- * @since Dev channel only.
- */
- export function getAvailableCapacity(id: string, callback: (info:
StorageCapacityInfo) => void): void;
-
- /** Fired when a new removable storage is attached to the system. */
- export var onAttached: SystemStorageAttachedEvent;
- /** Fired when a removable storage is detached from the system. */
- export var onDetached: SystemStorageDetachedEvent;
-}
-
-////////////////////
-// TabCapture
-////////////////////
-/**
- * Use the chrome.tabCapture API to interact with tab media streams.
- * Permissions: "tabCapture"
- * @since Chrome 31.
- */
-declare namespace chrome.tabCapture {
- interface CaptureInfo {
- /** The id of the tab whose status changed. */
- tabId: number;
- /**
- * The new capture status of the tab.
- * One of: "pending", "active", "stopped", or "error"
- */
- status: string;
- /** Whether an element in the tab being captured is in
fullscreen mode. */
- fullscreen: boolean;
- }
-
- interface CaptureOptions {
- /** Optional. */
- audio?: boolean;
- /** Optional. */
- video?: boolean;
- /** Optional. */
- audioConstraints?: MediaStreamConstraints;
- /** Optional. */
- videoConstraints?: MediaStreamConstraints;
- }
-
- interface CaptureStatusChangedEvent extends chrome.events.Event<(info:
CaptureInfo) => void> {}
-
- /**
- * Captures the visible area of the currently active tab. Capture can
only be started on the currently active tab after the extension has been
invoked. Capture is maintained across page navigations within the tab, and
stops when the tab is closed, or the media stream is closed by the extension.
- * @param options Configures the returned media stream.
- * @param callback Callback with either the tab capture stream or null.
- */
- export function capture(options: CaptureOptions, callback: (stream:
MediaStream) => void): void;
- /**
- * Returns a list of tabs that have requested capture or are being
captured, i.e. status != stopped and status != error. This allows extensions to
inform the user that there is an existing tab capture that would prevent a new
tab capture from succeeding (or to prevent redundant requests for the same tab).
- * @param callback Callback invoked with CaptureInfo[] for captured
tabs.
- */
- export function getCapturedTabs(callback: (result: CaptureInfo[]) =>
void): void;
-
- /** Event fired when the capture status of a tab changes. This allows
extension authors to keep track of the capture status of tabs to keep UI
elements like page actions in sync. */
- var onStatusChanged: CaptureStatusChangedEvent;
-}
-
-////////////////////
-// Tabs
-////////////////////
-/**
- * Use the chrome.tabs API to interact with the browser's tab system. You can
use this API to create, modify, and rearrange tabs in the browser.
- * Permissions: The majority of the chrome.tabs API can be used without
declaring any permission. However, the "tabs" permission is required in order
to populate the url, title, and favIconUrl properties of Tab.
- * @since Chrome 5.
- */
-declare namespace chrome.tabs {
- /**
- * Tab muted state and the reason for the last state change.
- * @since Chrome 46. Warning: this is the current Beta channel.
- */
- interface MutedInfo {
- /** Whether the tab is prevented from playing sound (but hasn't
necessarily recently produced sound). Equivalent to whether the muted audio
indicator is showing. */
- muted: boolean;
- /**
- * Optional.
- * The reason the tab was muted or unmuted. Not set if the
tab's mute state has never been changed.
- * "user": A user input action has set/overridden the muted
state.
- * "capture": Tab capture started, forcing a muted state change.
- * "extension": An extension, identified by the extensionId
field, set the muted state.
- */
- reason?: string;
- /**
- * Optional.
- * The ID of the extension that changed the muted state. Not
set if an extension was not the reason the muted state last changed.
- */
- extensionId?: string;
- }
-
- interface Tab {
- /**
- * Optional.
- * Either loading or complete.
- */
- status?: string;
- /** The zero-based index of the tab within its window. */
- index: number;
- /**
- * Optional.
- * The ID of the tab that opened this tab, if any. This
property is only present if the opener tab still exists.
- * @since Chrome 18.
- */
- openerTabId?: number;
- /**
- * Optional.
- * The title of the tab. This property is only present if the
extension's manifest includes the "tabs" permission.
- */
- title?: string;
- /**
- * Optional.
- * The URL the tab is displaying. This property is only present
if the extension's manifest includes the "tabs" permission.
- */
- url?: string;
- /**
- * Whether the tab is pinned.
- * @since Chrome 9.
- */
- pinned: boolean;
- /**
- * Whether the tab is highlighted.
- * @since Chrome 16.
- */
- highlighted: boolean;
- /** The ID of the window the tab is contained within. */
- windowId: number;
- /**
- * Whether the tab is active in its window. (Does not
necessarily mean the window is focused.)
- * @since Chrome 16.
- */
- active: boolean;
- /**
- * Optional.
- * The URL of the tab's favicon. This property is only present
if the extension's manifest includes the "tabs" permission. It may also be an
empty string if the tab is loading.
- */
- favIconUrl?: string;
- /**
- * Optional.
- * The ID of the tab. Tab IDs are unique within a browser
session. Under some circumstances a Tab may not be assigned an ID, for example
when querying foreign tabs using the sessions API, in which case a session ID
may be present. Tab ID can also be set to chrome.tabs.TAB_ID_NONE for apps and
devtools windows.
- */
- id?: number;
- /** Whether the tab is in an incognito window. */
- incognito: boolean;
- /**
- * Whether the tab is selected.
- * @deprecated since Chrome 33. Please use tabs.Tab.highlighted.
- */
- selected: boolean;
- /**
- * Optional.
- * Whether the tab has produced sound over the past couple of
seconds (but it might not be heard if also muted). Equivalent to whether the
speaker audio indicator is showing.
- * @since Chrome 45.
- */
- audible?: boolean;
- /**
- * Optional.
- * Current tab muted state and the reason for the last state
change.
- * @since Chrome 46. Warning: this is the current Beta channel.
- */
- mutedInfo?: MutedInfo;
- /**
- * Optional. The width of the tab in pixels.
- * @since Chrome 31.
- */
- width?: number;
- /**
- * Optional. The height of the tab in pixels.
- * @since Chrome 31.
- */
- height?: number;
- /**
- * Optional. The session ID used to uniquely identify a Tab
obtained from the sessions API.
- * @since Chrome 31.
- */
- sessionId?: string;
- }
-
- /**
- * Defines how zoom changes in a tab are handled and at what scope.
- * @since Chrome 38.
- */
- interface ZoomSettings {
- /**
- * Optional.
- * Defines how zoom changes are handled, i.e. which entity is
responsible for the actual scaling of the page; defaults to "automatic".
- * "automatic": Zoom changes are handled automatically by the
browser.
- * "manual": Overrides the automatic handling of zoom changes.
The onZoomChange event will still be dispatched, and it is the responsibility
of the extension to listen for this event and manually scale the page. This
mode does not support per-origin zooming, and will thus ignore the scope zoom
setting and assume per-tab.
- * "disabled": Disables all zooming in the tab. The tab will
revert to the default zoom level, and all attempted zoom changes will be
ignored.
- */
- mode?: string;
- /**
- * Optional.
- * Defines whether zoom changes will persist for the page's
origin, or only take effect in this tab; defaults to per-origin when in
automatic mode, and per-tab otherwise.
- * "per-origin": Zoom changes will persist in the zoomed page's
origin, i.e. all other tabs navigated to that same origin will be zoomed as
well. Moreover, per-origin zoom changes are saved with the origin, meaning that
when navigating to other pages in the same origin, they will all be zoomed to
the same zoom factor. The per-origin scope is only available in the automatic
mode.
- * "per-tab": Zoom changes only take effect in this tab, and
zoom changes in other tabs will not affect the zooming of this tab. Also,
per-tab zoom changes are reset on navigation; navigating a tab will always load
pages with their per-origin zoom factors.
- */
- scope?: string;
- /**
- * Optional.
- * Used to return the default zoom level for the current tab in
calls to tabs.getZoomSettings.
- * @since Chrome 43.
- */
- defaultZoomFactor?: number;
- }
-
- interface InjectDetails {
- /**
- * Optional.
- * If allFrames is true, implies that the JavaScript or CSS
should be injected into all frames of current page. By default, it's false and
is only injected into the top frame.
- */
- allFrames?: boolean;
- /**
- * Optional. JavaScript or CSS code to inject.
- * Warning: Be careful using the code parameter. Incorrect use
of it may open your extension to cross site scripting attacks.
- */
- code?: string;
- /**
- * Optional. The soonest that the JavaScript or CSS will be
injected into the tab.
- * One of: "document_start", "document_end", or "document_idle"
- * @since Chrome 20.
- */
- runAt?: string;
- /** Optional. JavaScript or CSS file to inject. */
- file?: string;
- /**
- * Optional.
- * If matchAboutBlank is true, then the code is also injected
in about:blank and about:srcdoc frames if your extension has access to its
parent document. Code cannot be inserted in top-level about:-frames. By default
it is false.
- * @since Chrome 39.
- */
- matchAboutBlank?: boolean;
- }
-
- interface CreateProperties {
- /** Optional. The position the tab should take in the window.
The provided value will be clamped to between zero and the number of tabs in
the window. */
- index?: number;
- /**
- * Optional.
- * The ID of the tab that opened this tab. If specified, the
opener tab must be in the same window as the newly created tab.
- * @since Chrome 18.
- */
- openerTabId?: number;
- /**
- * Optional.
- * The URL to navigate the tab to initially. Fully-qualified
URLs must include a scheme (i.e. 'http://www.google.com', not
'www.google.com'). Relative URLs will be relative to the current page within
the extension. Defaults to the New Tab Page.
- */
- url?: string;
- /**
- * Optional. Whether the tab should be pinned. Defaults to false
- * @since Chrome 9.
- */
- pinned?: boolean;
- /** Optional. The window to create the new tab in. Defaults to
the current window. */
- windowId?: number;
- /**
- * Optional.
- * Whether the tab should become the active tab in the window.
Does not affect whether the window is focused (see windows.update). Defaults to
true.
- * @since Chrome 16.
- */
- active?: boolean;
- /**
- * Optional. Whether the tab should become the selected tab in
the window. Defaults to true
- * @deprecated since Chrome 33. Please use active.
- */
- selected?: boolean;
- }
-
- interface MoveProperties {
- /** The position to move the window to. -1 will place the tab
at the end of the window. */
- index: number;
- /** Optional. Defaults to the window the tab is currently in. */
- windowId?: number;
- }
-
- interface UpdateProperties {
- /**
- * Optional. Whether the tab should be pinned.
- * @since Chrome 9.
- */
- pinned?: boolean;
- /**
- * Optional. The ID of the tab that opened this tab. If
specified, the opener tab must be in the same window as this tab.
- * @since Chrome 18.
- */
- openerTabId?: number;
- /** Optional. A URL to navigate the tab to. */
- url?: string;
- /**
- * Optional. Adds or removes the tab from the current selection.
- * @since Chrome 16.
- */
- highlighted?: boolean;
- /**
- * Optional. Whether the tab should be active. Does not affect
whether the window is focused (see windows.update).
- * @since Chrome 16.
- */
- active?: boolean;
- /**
- * Optional. Whether the tab should be selected.
- * @deprecated since Chrome 33. Please use highlighted.
- */
- selected?: boolean;
- /**
- * Optional. Whether the tab should be muted.
- * @since Chrome 45.
- */
- muted?: boolean;
- }
-
- interface CaptureVisibleTabOptions {
- /**
- * Optional.
- * When format is "jpeg", controls the quality of the resulting
image. This value is ignored for PNG images. As quality is decreased, the
resulting image will have more visual artifacts, and the number of bytes needed
to store it will decrease.
- */
- quality?: number;
- /**
- * Optional. The format of an image.
- * One of: "jpeg", or "png"
- */
- format?: string;
- }
-
- interface ReloadProperties {
- /** Optional. Whether using any local cache. Default is false.
*/
- bypassCache?: boolean;
- }
-
- interface ConnectInfo {
- /** Optional. Will be passed into onConnect for content scripts
that are listening for the connection event. */
- name?: string;
- /**
- * Open a port to a specific frame identified by frameId
instead of all frames in the tab.
- * @since Chrome 41.
- */
- frameId?: number;
- }
-
- interface MessageSendOptions {
- /** Optional. Send a message to a specific frame identified by
frameId instead of all frames in the tab. */
- frameId?: number;
- }
-
- interface HighlightInfo {
- /** One or more tab indices to highlight. */
- tabs: number | number[];
- /** Optional. The window that contains the tabs. */
- windowId?: number;
- }
-
- interface QueryInfo {
- /**
- * Optional. Whether the tabs have completed loading.
- * One of: "loading", or "complete"
- */
- status?: string;
- /**
- * Optional. Whether the tabs are in the last focused window.
- * @since Chrome 19.
- */
- lastFocusedWindow?: boolean;
- /** Optional. The ID of the parent window, or
windows.WINDOW_ID_CURRENT for the current window. */
- windowId?: number;
- /**
- * Optional. The type of window the tabs are in.
- * One of: "normal", "popup", "panel", "app", or "devtools"
- */
- windowType?: string;
- /** Optional. Whether the tabs are active in their windows. */
- active?: boolean;
- /**
- * Optional. The position of the tabs within their windows.
- * @since Chrome 18.
- */
- index?: number;
- /** Optional. Match page titles against a pattern. */
- title?: string;
- /** Optional. Match tabs against one or more URL patterns. Note
that fragment identifiers are not matched. */
- url?: string | string[];
- /**
- * Optional. Whether the tabs are in the current window.
- * @since Chrome 19.
- */
- currentWindow?: boolean;
- /** Optional. Whether the tabs are highlighted. */
- highlighted?: boolean;
- /** Optional. Whether the tabs are pinned. */
- pinned?: boolean;
- /**
- * Optional. Whether the tabs are audible.
- * @since Chrome 45.
- */
- audible?: boolean;
- /**
- * Optional. Whether the tabs are muted.
- * @since Chrome 45.
- */
- muted?: boolean;
- }
-
- interface TabHighlightInfo {
- windowId: number;
- tabIds: number[];
- }
-
- interface TabRemoveInfo {
- /**
- * The window whose tab is closed.
- * @since Chrome 25.
- */
- windowId: number;
- /** True when the tab is being closed because its window is
being closed. */
- isWindowClosing: boolean;
- }
-
- interface TabAttachInfo {
- newPosition: number;
- newWindowId: number;
- }
-
- interface TabChangeInfo {
- /** Optional. The status of the tab. Can be either loading or
complete. */
- status?: string;
- /**
- * The tab's new pinned state.
- * @since Chrome 9.
- */
- pinned?: boolean;
- /** Optional. The tab's URL if it has changed. */
- url?: string;
- /**
- * The tab's new audible state.
- * @since Chrome 45.
- */
- audible?: boolean;
- /**
- * The tab's new muted state and the reason for the change.
- * @since Chrome 46. Warning: this is the current Beta channel.
- */
- mutedInfo?: MutedInfo;
- /**
- * The tab's new favicon URL.
- * @since Chrome 27.
- */
- favIconUrl?: string;
- /**
- * The tab's new title.
- * @since Chrome 48.
- */
- title?: string;
- }
-
- interface TabMoveInfo {
- toIndex: number;
- windowId: number;
- fromIndex: number;
- }
-
- interface TabDetachInfo {
- oldWindowId: number;
- oldPosition: number;
- }
-
- interface TabActiveInfo {
- /** The ID of the tab that has become active. */
- tabId: number;
- /** The ID of the window the active tab changed inside of. */
- windowId: number;
- }
-
- interface TabWindowInfo {
- /** The ID of the window of where the tab is located. */
- windowId: number;
- }
-
- interface ZoomChangeInfo {
- tabId: number;
- oldZoomFactor: number;
- newZoomFactor: number;
- zoomSettings: ZoomSettings;
- }
-
- interface TabHighlightedEvent extends chrome.events.Event<(highlightInfo:
HighlightInfo) => void> {}
-
- interface TabRemovedEvent extends chrome.events.Event<(tabId: number,
removeInfo: TabRemoveInfo) => void> {}
-
- interface TabUpdatedEvent extends chrome.events.Event<(tabId: number,
changeInfo: TabChangeInfo, tab: Tab) => void> {}
-
- interface TabAttachedEvent extends chrome.events.Event<(tabId: number,
attachInfo: TabAttachInfo) => void> {}
-
- interface TabMovedEvent extends chrome.events.Event<(tabId: number,
moveInfo: TabMoveInfo) => void> {}
-
- interface TabDetachedEvent extends chrome.events.Event<(tabId: number,
detachInfo: TabDetachInfo) => void> {}
-
- interface TabCreatedEvent extends chrome.events.Event<(tab: Tab) => void>
{}
-
- interface TabActivatedEvent extends chrome.events.Event<(activeInfo:
TabActiveInfo) => void> {}
-
- interface TabReplacedEvent extends chrome.events.Event<(addedTabId:
number, removedTabId: number) => void> {}
-
- interface TabSelectedEvent extends chrome.events.Event<(tabId: number,
selectInfo: TabWindowInfo) => void> {}
-
- interface TabZoomChangeEvent extends
chrome.events.Event<(ZoomChangeInfo: ZoomChangeInfo) => void> {}
-
- /**
- * Injects JavaScript code into a page. For details, see the
programmatic injection section of the content scripts doc.
- * @param details Details of the script or CSS to inject. Either the
code or the file property must be set, but both may not be set at the same time.
- * @param callback Optional. Called after all the JavaScript has been
executed.
- * Parameter result: The result of the script in every injected frame.
- */
- export function executeScript(details: InjectDetails, callback?: (result:
any[]) => void): void;
- /**
- * Injects JavaScript code into a page. For details, see the
programmatic injection section of the content scripts doc.
- * @param tabId Optional. The ID of the tab in which to run the script;
defaults to the active tab of the current window.
- * @param details Details of the script or CSS to inject. Either the
code or the file property must be set, but both may not be set at the same time.
- * @param callback Optional. Called after all the JavaScript has been
executed.
- * Parameter result: The result of the script in every injected frame.
- */
- export function executeScript(tabId: number, details: InjectDetails,
callback?: (result: any[]) => void): void;
- /** Retrieves details about the specified tab. */
- export function get(tabId: number, callback: (tab: Tab) => void): void;
- /**
- * Gets details about all tabs in the specified window.
- * @deprecated since Chrome 33. Please use tabs.query {windowId:
windowId}.
- */
- export function getAllInWindow(callback: (tab: Tab) => void): void;
- /**
- * Gets details about all tabs in the specified window.
- * @deprecated since Chrome 33. Please use tabs.query {windowId:
windowId}.
- * @param windowId Optional. Defaults to the current window.
- */
- export function getAllInWindow(windowId: number, callback: (tab: Tab)
=> void): void;
- /** Gets the tab that this script call is being made from. May be
undefined if called from a non-tab context (for example: a background page or
popup view). */
- export function getCurrent(callback: (tab?: Tab) => void): void;
- /**
- * Gets the tab that is selected in the specified window.
- * @deprecated since Chrome 33. Please use tabs.query {active: true}.
- */
- export function getSelected(callback: (tab: Tab) => void): void;
- /**
- * Gets the tab that is selected in the specified window.
- * @deprecated since Chrome 33. Please use tabs.query {active: true}.
- * @param windowId Optional. Defaults to the current window.
- */
- export function getSelected(windowId: number, callback: (tab: Tab) =>
void): void;
- /**
- * Creates a new tab.
- * @param callback Optional.
- * Parameter tab: Details about the created tab. Will contain the ID of
the new tab.
- */
- export function create(createProperties: CreateProperties, callback?:
(tab: Tab) => void): void;
- /**
- * Moves one or more tabs to a new position within its window, or to a
new window. Note that tabs can only be moved to and from normal (window.type
=== "normal") windows.
- * @param tabId The tab to move.
- * @param callback Optional.
- * Parameter tab: Details about the moved tab.
- */
- export function move(tabId: number, moveProperties: MoveProperties,
callback?: (tab: Tab) => void): void;
- /**
- * Moves one or more tabs to a new position within its window, or to a
new window. Note that tabs can only be moved to and from normal (window.type
=== "normal") windows.
- * @param tabIds The tabs to move.
- * @param callback Optional.
- * Parameter tabs: Details about the moved tabs.
- */
- export function move(tabIds: number[], moveProperties: MoveProperties,
callback?: (tabs: Tab[]) => void): void;
- /**
- * Modifies the properties of a tab. Properties that are not specified
in updateProperties are not modified.
- * @param callback Optional.
- * Optional parameter tab: Details about the updated tab. The tabs.Tab
object doesn't contain url, title and favIconUrl if the "tabs" permission has
not been requested.
- */
- export function update(updateProperties: UpdateProperties, callback?:
(tab?: Tab) => void): void;
- /**
- * Modifies the properties of a tab. Properties that are not specified
in updateProperties are not modified.
- * @param tabId Defaults to the selected tab of the current window.
- * @param callback Optional.
- * Optional parameter tab: Details about the updated tab. The tabs.Tab
object doesn't contain url, title and favIconUrl if the "tabs" permission has
not been requested.
- */
- export function update(tabId: number, updateProperties: UpdateProperties,
callback?: (tab?: Tab) => void): void;
- /**
- * Closes a tab.
- * @param tabId The tab to close.
- */
- export function remove(tabId: number, callback?: Function): void;
- /**
- * Closes several tabs.
- * @param tabIds The list of tabs to close.
- */
- export function remove(tabIds: number[], callback?: Function): void;
- /**
- * Captures the visible area of the currently active tab in the
specified window. You must have <all_urls> permission to use this method.
- * @param callback
- * Parameter dataUrl: 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.
- */
- export function captureVisibleTab(callback: (dataUrl: string) => void):
void;
- /**
- * Captures the visible area of the currently active tab in the
specified window. You must have <all_urls> permission to use this method.
- * @param windowId Optional. The target window. Defaults to the current
window.
- * @param callback
- * Parameter dataUrl: 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.
- */
- export function captureVisibleTab(windowId: number, callback: (dataUrl:
string) => void): void;
- /**
- * Captures the visible area of the currently active tab in the
specified window. You must have <all_urls> permission to use this method.
- * @param options Optional. Details about the format and quality of an
image.
- * @param callback
- * Parameter dataUrl: 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.
- */
- export function captureVisibleTab(options: CaptureVisibleTabOptions,
callback: (dataUrl: string) => void): void;
- /**
- * Captures the visible area of the currently active tab in the
specified window. You must have <all_urls> permission to use this method.
- * @param windowId Optional. The target window. Defaults to the current
window.
- * @param options Optional. Details about the format and quality of an
image.
- * @param callback
- * Parameter dataUrl: 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.
- */
- export function captureVisibleTab(windowId: number, options:
CaptureVisibleTabOptions, callback: (dataUrl: string) => void): void;
- /**
- * Reload a tab.
- * @since Chrome 16.
- * @param tabId The ID of the tab to reload; defaults to the selected
tab of the current window.
- */
- export function reload(tabId: number, reloadProperties?:
ReloadProperties, callback?: () => void): void;
- /**
- * Reload the selected tab of the current window.
- * @since Chrome 16.
- */
- export function reload(reloadProperties: ReloadProperties, callback?:
() => void): void;
- /**
- * Reload the selected tab of the current window.
- * @since Chrome 16.
- */
- export function reload(callback?: () => void): void;
- /**
- * Duplicates a tab.
- * @since Chrome 23.
- * @param tabId The ID of the tab which is to be duplicated.
- * @param callback Optional.
- * Optional parameter tab: Details about the duplicated tab. The
tabs.Tab object doesn't contain url, title and favIconUrl if the "tabs"
permission has not been requested.
- */
- export function duplicate(tabId: number, callback?: (tab?: Tab) => void):
void;
- /**
- * Sends a single message to the content script(s) in the specified
tab, with an optional callback to run when a response is sent back. The
runtime.onMessage event is fired in each content script running in the
specified tab for the current extension.
- * @since Chrome 20.
- */
- export function sendMessage(tabId: number, message: any,
responseCallback?: (response: any) => void): void;
- /**
- * Sends a single message to the content script(s) in the specified
tab, with an optional callback to run when a response is sent back. The
runtime.onMessage event is fired in each content script running in the
specified tab for the current extension.
- * @since Chrome 41.
- * @param responseCallback Optional.
- * Parameter response: The JSON response object sent by the handler of
the message. If an error occurs while connecting to the specified tab, the
callback will be called with no arguments and runtime.lastError will be set to
the error message.
- */
- export function sendMessage(tabId: number, message: any, options:
MessageSendOptions, responseCallback?: (response: any) => void): void;
- /**
- * Sends a single request to the content script(s) in the specified
tab, with an optional callback to run when a response is sent back. The
extension.onRequest event is fired in each content script running in the
specified tab for the current extension.
- * @deprecated since Chrome 33. Please use runtime.sendMessage.
- * @param responseCallback Optional.
- * Parameter response: The JSON response object sent by the handler of
the request. If an error occurs while connecting to the specified tab, the
callback will be called with no arguments and runtime.lastError will be set to
the error message.
- */
- export function sendRequest(tabId: number, request: any,
responseCallback?: (response: any) => void): void;
- /** Connects to the content script(s) in the specified tab. The
runtime.onConnect event is fired in each content script running in the
specified tab for the current extension. */
- export function connect(tabId: number, connectInfo?: ConnectInfo):
runtime.Port;
- /**
- * Injects CSS into a page. For details, see the programmatic injection
section of the content scripts doc.
- * @param details Details of the script or CSS to inject. Either the
code or the file property must be set, but both may not be set at the same time.
- * @param callback Optional. Called when all the CSS has been inserted.
- */
- export function insertCSS(details: InjectDetails, callback?: Function):
void;
- /**
- * Injects CSS into a page. For details, see the programmatic injection
section of the content scripts doc.
- * @param tabId Optional. The ID of the tab in which to insert the CSS;
defaults to the active tab of the current window.
- * @param details Details of the script or CSS to inject. Either the
code or the file property must be set, but both may not be set at the same time.
- * @param callback Optional. Called when all the CSS has been inserted.
- */
- export function insertCSS(tabId: number, details: InjectDetails,
callback?: Function): void;
- /**
- * Highlights the given tabs.
- * @since Chrome 16.
- * @param callback Optional.
- * Parameter window: Contains details about the window whose tabs were
highlighted.
- */
- export function highlight(highlightInfo: HighlightInfo, callback: (window:
chrome.windows.Window) => void): void;
- /**
- * Gets all tabs that have the specified properties, or all tabs if no
properties are specified.
- * @since Chrome 16.
- */
- export function query(queryInfo: QueryInfo, callback: (result: Tab[]) =>
void): void;
- /**
- * Detects the primary language of the content in a tab.
- * @param callback
- * Parameter language: An ISO language code such as en or fr. For a
complete list of languages supported by this method, see kLanguageInfoTable.
The 2nd to 4th columns will be checked and the first non-NULL value will be
returned except for Simplified Chinese for which zh-CN will be returned. For an
unknown language, und will be returned.
- */
- export function detectLanguage(callback: (language: string) => void): void;
- /**
- * Detects the primary language of the content in a tab.
- * @param tabId Optional. Defaults to the active tab of the current
window.
- * @param callback
- * Parameter language: An ISO language code such as en or fr. For a
complete list of languages supported by this method, see kLanguageInfoTable.
The 2nd to 4th columns will be checked and the first non-NULL value will be
returned except for Simplified Chinese for which zh-CN will be returned. For an
unknown language, und will be returned.
- */
- export function detectLanguage(tabId: number, callback: (language: string)
=> void): void;
- /**
- * Zooms a specified tab.
- * @since Chrome 42.
- * @param zoomFactor The new zoom factor. Use a value of 0 here to set
the tab to its current default zoom factor. Values greater than zero specify a
(possibly non-default) zoom factor for the tab.
- * @param callback Optional. Called after the zoom factor has been
changed.
- */
- export function setZoom(zoomFactor: number, callback?: () => void):
void;
- /**
- * Zooms a specified tab.
- * @since Chrome 42.
- * @param tabId Optional. The ID of the tab to zoom; defaults to the
active tab of the current window.
- * @param zoomFactor The new zoom factor. Use a value of 0 here to set
the tab to its current default zoom factor. Values greater than zero specify a
(possibly non-default) zoom factor for the tab.
- * @param callback Optional. Called after the zoom factor has been
changed.
- */
- export function setZoom(tabId: number, zoomFactor: number, callback?:
() => void): void;
- /**
- * Gets the current zoom factor of a specified tab.
- * @since Chrome 42.
- * @param callback Called with the tab's current zoom factor after it
has been fetched.
- * Parameter zoomFactor: The tab's current zoom factor.
- */
- export function getZoom(callback: (zoomFactor: number) => void): void;
- /**
- * Gets the current zoom factor of a specified tab.
- * @since Chrome 42.
- * @param tabId Optional. The ID of the tab to get the current zoom
factor from; defaults to the active tab of the current window.
- * @param callback Called with the tab's current zoom factor after it
has been fetched.
- * Parameter zoomFactor: The tab's current zoom factor.
- */
- export function getZoom(tabId: number, callback: (zoomFactor: number)
=> void): void;
- /**
- * Sets the zoom settings for a specified tab, which define how zoom
changes are handled. These settings are reset to defaults upon navigating the
tab.
- * @since Chrome 42.
- * @param zoomSettings Defines how zoom changes are handled and at what
scope.
- * @param callback Optional. Called after the zoom settings have been
changed.
- */
- export function setZoomSettings(zoomSettings: ZoomSettings, callback?:
() => void): void;
- /**
- * Sets the zoom settings for a specified tab, which define how zoom
changes are handled. These settings are reset to defaults upon navigating the
tab.
- * @since Chrome 42.
- * @param tabId Optional. The ID of the tab to change the zoom settings
for; defaults to the active tab of the current window.
- * @param zoomSettings Defines how zoom changes are handled and at what
scope.
- * @param callback Optional. Called after the zoom settings have been
changed.
- */
- export function setZoomSettings(tabId: number, zoomSettings:
ZoomSettings, callback?: () => void): void;
- /**
- * Gets the current zoom settings of a specified tab.
- * @since Chrome 42.
- * @param callback Called with the tab's current zoom settings.
- * Paramater zoomSettings: The tab's current zoom settings.
- */
- export function getZoomSettings(callback: (zoomSettings: ZoomSettings)
=> void): void;
- /**
- * Gets the current zoom settings of a specified tab.
- * @since Chrome 42.
- * @param tabId Optional. The ID of the tab to get the current zoom
settings from; defaults to the active tab of the current window.
- * @param callback Called with the tab's current zoom settings.
- * Paramater zoomSettings: The tab's current zoom settings.
- */
- export function getZoomSettings(tabId: number, callback: (zoomSettings:
ZoomSettings) => void): void;
-
- /**
- * Fired when the highlighted or selected tabs in a window changes.
- * @since Chrome 18.
- */
- var onHighlighted: TabHighlightedEvent;
- /** Fired when a tab is closed. */
- var onRemoved: TabRemovedEvent;
- /** Fired when a tab is updated. */
- var onUpdated: TabUpdatedEvent;
- /** Fired when a tab is attached to a window, for example because it
was moved between windows. */
- var onAttached: TabAttachedEvent;
- /**
- * Fired when a tab is moved within a window. Only one move event is
fired, representing the tab the user directly moved. Move events are not fired
for the other tabs that must move in response. This event is not fired when a
tab is moved between windows. For that, see tabs.onDetached.
- */
- var onMoved: TabMovedEvent;
- /** Fired when a tab is detached from a window, for example because it
is being moved between windows. */
- var onDetached: TabDetachedEvent;
- /** Fired when a tab is created. Note that the tab's URL may not be set
at the time this event fired, but you can listen to onUpdated events to be
notified when a URL is set. */
- var onCreated: TabCreatedEvent;
- /**
- * Fires when the active tab in a window changes. Note that the tab's
URL may not be set at the time this event fired, but you can listen to
onUpdated events to be notified when a URL is set.
- * @since Chrome 18.
- */
- var onActivated: TabActivatedEvent;
- /**
- * Fired when a tab is replaced with another tab due to prerendering or
instant.
- * @since Chrome 26.
- */
- var onReplaced: TabReplacedEvent;
- /**
- * @deprecated since Chrome 33. Please use tabs.onActivated.
- * Fires when the selected tab in a window changes.
- */
- var onSelectionChanged: TabSelectedEvent;
- /**
- * @deprecated since Chrome 33. Please use tabs.onActivated.
- * Fires when the selected tab in a window changes. Note that the tab's
URL may not be set at the time this event fired, but you can listen to
tabs.onUpdated events to be notified when a URL is set.
- */
- var onActiveChanged: TabSelectedEvent;
- /**
- * @deprecated since Chrome 33. Please use tabs.onHighlighted.
- * Fired when the highlighted or selected tabs in a window changes.
- */
- var onHighlightChanged: TabHighlightedEvent;
- /**
- * Fired when a tab is zoomed.
- * @since Chrome 38.
- */
- var onZoomChange: TabZoomChangeEvent;
-}
-
-////////////////////
-// Top Sites
-////////////////////
-/**
- * Use the chrome.topSites API to access the top sites that are displayed on
the new tab page.
- * Permissions: "topSites"
- * @since Chrome 19.
- */
-declare namespace chrome.topSites {
- /** An object encapsulating a most visited URL, such as the URLs on the
new tab page. */
- interface MostVisitedURL {
- /** The most visited URL. */
- url: string;
- /** The title of the page */
- title: string;
- }
-
- /** Gets a list of top sites. */
- export function get(callback: (data: MostVisitedURL[]) => void): void;
-}
-
-////////////////////
-// Text to Speech
-////////////////////
-/**
- * Use the chrome.tts API to play synthesized text-to-speech (TTS). See also
the related ttsEngine API, which allows an extension to implement a speech
engine.
- * Permissions: "tts"
- * @since Chrome 14.
- */
-declare namespace chrome.tts {
- /** An event from the TTS engine to communicate the status of an
utterance. */
- interface TtsEvent {
- /** Optional. The index of the current character in the
utterance. */
- charIndex?: number;
- /** Optional. The error description, if the event type is
'error'. */
- errorMessage?: string;
- /**
- * The type can be 'start' as soon as speech has started,
'word' when a word boundary is reached, 'sentence' when a sentence boundary is
reached, 'marker' when an SSML mark element is reached, 'end' when the end of
the utterance is reached, 'interrupted' when the utterance is stopped or
interrupted before reaching the end, 'cancelled' when it's removed from the
queue before ever being synthesized, or 'error' when any other error occurs.
When pausing speech, a 'pause' event is fired if [...]
- * One of: "start", "end", "word", "sentence", "marker",
"interrupted", "cancelled", "error", "pause", or "resume"
- */
- type: string;
- }
-
- /** A description of a voice available for speech synthesis. */
- interface TtsVoice {
- /** Optional. The language that this voice supports, in the
form language-region. Examples: 'en', 'en-US', 'en-GB', 'zh-CN'. */
- lang?: string;
- /**
- * Optional. This voice's gender.
- * One of: "male", or "female"
- */
- gender?: string;
- /** Optional. The name of the voice. */
- voiceName?: string;
- /** The ID of the extension providing this voice. */
- extensionsId?: string;
- /** All of the callback event types that this voice is capable
of sending. */
- eventTypes?: string[];
- /**
- * If true, the synthesis engine is a remote network resource.
It may be higher latency and may incur bandwidth costs.
- * @since Chrome 33.
- */
- remote?: boolean;
- }
-
- interface SpeakOptions {
- /** Optional. Speaking volume between 0 and 1 inclusive, with 0
being lowest and 1 being highest, with a default of 1.0. */
- volume?: number;
- /**
- * Optional.
- * If true, enqueues this utterance if TTS is already in
progress. If false (the default), interrupts any current speech and flushes the
speech queue before speaking this new utterance.
- */
- enqueue?: boolean;
- /**
- * Optional.
- * Speaking rate relative to the default rate for this voice.
1.0 is the default rate, normally around 180 to 220 words per minute. 2.0 is
twice as fast, and 0.5 is half as fast. Values below 0.1 or above 10.0 are
strictly disallowed, but many voices will constrain the minimum and maximum
rates further—for example a particular voice may not actually speak faster than
3 times normal even if you specify a value larger than 3.0.
- */
- rate?: number;
- /**
- * Optional. This function is called with events that occur in
the process of speaking the utterance.
- * @param event The update event from the text-to-speech engine
indicating the status of this utterance.
- */
- onEvent?: (event: TtsEvent) => void;
- /**
- * Optional.
- * Speaking pitch between 0 and 2 inclusive, with 0 being
lowest and 2 being highest. 1.0 corresponds to a voice's default pitch.
- */
- pitch?: number;
- /** Optional. The language to be used for synthesis, in the
form language-region. Examples: 'en', 'en-US', 'en-GB', 'zh-CN'. */
- lang?: string;
- /** Optional. The name of the voice to use for synthesis. If
empty, uses any available voice. */
- voiceName?: string;
- /** Optional. The extension ID of the speech engine to use, if
known. */
- extensionId?: string;
- /**
- * Optional. Gender of voice for synthesized speech.
- * One of: "male", or "female"
- */
- gender?: string;
- /** Optional. The TTS event types the voice must support. */
- requiredEventTypes?: string[];
- /** Optional. The TTS event types that you are interested in
listening to. If missing, all event types may be sent. */
- desiredEventTypes?: string[];
- }
-
- /** Checks whether the engine is currently speaking. On Mac OS X, the
result is true whenever the system speech engine is speaking, even if the
speech wasn't initiated by Chrome. */
- export function isSpeaking(callback?: (speaking: boolean) => void): void;
- /** Stops any current speech and flushes the queue of any pending
utterances. In addition, if speech was paused, it will now be un-paused for the
next call to speak. */
- export function stop(): void;
- /** Gets an array of all available voices. */
- export function getVoices(callback?: (voices: TtsVoice[]) => void): void;
- /**
- * Speaks text using a text-to-speech engine.
- * @param utterance The text to speak, either plain text or a complete,
well-formed SSML document. Speech engines that do not support SSML will strip
away the tags and speak the text. The maximum length of the text is 32,768
characters.
- * @param callback Optional. Called right away, before speech finishes.
Check chrome.runtime.lastError to make sure there were no errors. Use
options.onEvent to get more detailed feedback.
- */
- export function speak(utterance: string, callback?: Function): void;
- /**
- * Speaks text using a text-to-speech engine.
- * @param utterance The text to speak, either plain text or a complete,
well-formed SSML document. Speech engines that do not support SSML will strip
away the tags and speak the text. The maximum length of the text is 32,768
characters.
- * @param options Optional. The speech options.
- * @param callback Optional. Called right away, before speech finishes.
Check chrome.runtime.lastError to make sure there were no errors. Use
options.onEvent to get more detailed feedback.
- */
- export function speak(utterance: string, options: SpeakOptions,
callback?: Function): void;
- /**
- * Pauses speech synthesis, potentially in the middle of an utterance.
A call to resume or stop will un-pause speech.
- * @since Chrome 29.
- */
- export function pause(): void;
- /**
- * If speech was paused, resumes speaking where it left off.
- * @since Chrome 29.
- */
- export function resume(): void;
-}
-
-////////////////////
-// Text to Speech Engine
-////////////////////
-/**
- * Use the chrome.ttsEngine API to implement a text-to-speech(TTS) engine
using an extension. If your extension registers using this API, it will receive
events containing an utterance to be spoken and other parameters when any
extension or Chrome App uses the tts API to generate speech. Your extension can
then use any available web technology to synthesize and output the speech, and
send events back to the calling function to report the status.
- * Permissions: "ttsEngine"
- * @since Chrome 14.
- */
-declare namespace chrome.ttsEngine {
- interface SpeakOptions {
- /** Optional. The language to be used for synthesis, in the
form language-region. Examples: 'en', 'en-US', 'en-GB', 'zh-CN'. */
- lang?: string;
- /** Optional. The name of the voice to use for synthesis. */
- voiceName?: string;
- /**
- * Optional. Gender of voice for synthesized speech.
- * One of: "male", or "female"
- */
- gender?: string;
- /** Optional. Speaking volume between 0 and 1 inclusive, with 0
being lowest and 1 being highest, with a default of 1.0. */
- volume?: number;
- /**
- * Optional.
- * Speaking rate relative to the default rate for this voice.
1.0 is the default rate, normally around 180 to 220 words per minute. 2.0 is
twice as fast, and 0.5 is half as fast. This value is guaranteed to be between
0.1 and 10.0, inclusive. When a voice does not support this full range of
rates, don't return an error. Instead, clip the rate to the range the voice
supports.
- */
- rate?: number;
- /** Optional. Speaking pitch between 0 and 2 inclusive, with 0
being lowest and 2 being highest. 1.0 corresponds to this voice's default
pitch. */
- pitch?: number;
- }
-
- interface TtsEngineSpeakEvent extends chrome.events.Event<(utterance:
string, options: SpeakOptions, sendTtsEvent: (event: chrome.tts.TtsEvent) =>
void) => void> {}
-
- /** Called when the user makes a call to tts.speak() and one of the
voices from this extension's manifest is the first to match the options object.
*/
- var onSpeak: TtsEngineSpeakEvent;
- /** Fired when a call is made to tts.stop and this extension may be in
the middle of speaking. If an extension receives a call to onStop and speech is
already stopped, it should do nothing (not raise an error). If speech is in the
paused state, this should cancel the paused state. */
- var onStop: chrome.events.Event<() => void>;
- /**
- * Optional: if an engine supports the pause event, it should pause the
current utterance being spoken, if any, until it receives a resume event or
stop event. Note that a stop event should also clear the paused state.
- * @since Chrome 29.
- */
- var onPause: chrome.events.Event<() => void>;
- /**
- * Optional: if an engine supports the pause event, it should also
support the resume event, to continue speaking the current utterance, if any.
Note that a stop event should also clear the paused state.
- * @since Chrome 29.
- */
- var onResume: chrome.events.Event<() => void>;
-}
-
-////////////////////
-// Types
-////////////////////
-/**
- * The chrome.types API contains type declarations for Chrome.
- * @since Chrome 13.
- */
-declare namespace chrome.types {
- interface ChromeSettingClearDetails {
- /**
- * Optional.
- * The scope of the ChromeSetting. One of
- * • regular: setting for the regular profile (which is
inherited by the incognito profile if not overridden elsewhere),
- * • regular_only: setting for the regular profile only (not
inherited by the incognito profile),
- * • incognito_persistent: setting for the incognito profile
that survives browser restarts (overrides regular preferences),
- * • incognito_session_only: setting for the incognito profile
that can only be set during an incognito session and is deleted when the
incognito session ends (overrides regular and incognito_persistent preferences).
- */
- scope?: string;
- }
-
- interface ChromeSettingSetDetails extends ChromeSettingClearDetails {
- /**
- * The value of the setting.
- * Note that every setting has a specific value type, which is
described together with the setting. An extension should not set a value of a
different type.
- */
- value: any;
- /**
- * Optional.
- * The scope of the ChromeSetting. One of
- * • regular: setting for the regular profile (which is
inherited by the incognito profile if not overridden elsewhere),
- * • regular_only: setting for the regular profile only (not
inherited by the incognito profile),
- * • incognito_persistent: setting for the incognito profile
that survives browser restarts (overrides regular preferences),
- * • incognito_session_only: setting for the incognito profile
that can only be set during an incognito session and is deleted when the
incognito session ends (overrides regular and incognito_persistent preferences).
- */
- scope?: string;
- }
-
- interface ChromeSettingGetDetails {
- /** Optional. Whether to return the value that applies to the
incognito session (default false). */
- incognito?: boolean;
- }
-
- /**
- * @param details Details of the currently effective value.
- */
- type DetailsCallback = (details: ChromeSettingGetResultDetails) => void;
-
- interface ChromeSettingGetResultDetails {
- /**
- * One of
- * • not_controllable: cannot be controlled by any extension
- * • controlled_by_other_extensions: controlled by extensions
with higher precedence
- * • controllable_by_this_extension: can be controlled by this
extension
- * • controlled_by_this_extension: controlled by this extension
- */
- levelOfControl: string;
- /** The value of the setting. */
- value: any;
- /**
- * Optional.
- * Whether the effective value is specific to the incognito
session.
- * This property will only be present if the incognito property
in the details parameter of get() was true.
- */
- incognitoSpecific?: boolean;
- }
-
- interface ChromeSettingChangedEvent extends
chrome.events.Event<DetailsCallback> {}
-
- /** An interface that allows access to a Chrome browser setting. See
accessibilityFeatures for an example. */
- interface ChromeSetting {
- /**
- * Sets the value of a setting.
- * @param details Which setting to change.
- * @param callback Optional. Called at the completion of the
set operation.
- */
- set(details: ChromeSettingSetDetails, callback?: Function): void;
- /**
- * Gets the value of a setting.
- * @param details Which setting to consider.
- */
- get(details: ChromeSettingGetDetails, callback?: DetailsCallback):
void;
- /**
- * Clears the setting, restoring any default value.
- * @param details Which setting to clear.
- * @param callback Optional. Called at the completion of the
clear operation.
- */
- clear(details: ChromeSettingClearDetails, callback?: Function): void;
- /** Fired after the setting changes. */
- onChange: ChromeSettingChangedEvent;
- }
-}
-
-////////////////////
-// VPN Provider
-////////////////////
-/**
- * Use the chrome.vpnProvider API to implement a VPN client.
- * Permissions: "vpnProvider"
- * Important: This API works only on Chrome OS.
- * @since Chrome 43.
- */
-declare namespace chrome.vpnProvider {
- interface VpnSessionParameters {
- /** IP address for the VPN interface in CIDR notation. IPv4 is
currently the only supported mode. */
- address: string;
- /** Optional. Broadcast address for the VPN interface.
(default: deduced from IP address and mask) */
- broadcastAddress?: string;
- /** Optional. MTU setting for the VPN interface. (default: 1500
bytes) */
- mtu?: string;
- /**
- * Exclude network traffic to the list of IP blocks in CIDR
notation from the tunnel. This can be used to bypass traffic to and from the
VPN server. When many rules match a destination, the rule with the longest
matching prefix wins. Entries that correspond to the same CIDR block are
treated as duplicates. Such duplicates in the collated (exclusionList +
inclusionList) list are eliminated and the exact duplicate entry that will be
eliminated is undefined.
- */
- exclusionList: string[];
- /**
- * Include network traffic to the list of IP blocks in CIDR
notation to the tunnel. This parameter can be used to set up a split tunnel. By
default no traffic is directed to the tunnel. Adding the entry "0.0.0.0/0" to
this list gets all the user traffic redirected to the tunnel. When many rules
match a destination, the rule with the longest matching prefix wins. Entries
that correspond to the same CIDR block are treated as duplicates. Such
duplicates in the collated (exclusionList + in [...]
- */
- inclusionList: string[];
- /** Optional. A list of search domains. (default: no search
domain) */
- domainSearch?: string[];
- /** A list of IPs for the DNS servers. */
- dnsServer: string[];
- }
-
- interface VpnPlatformMessageEvent extends chrome.events.Event<(id:
string, message: string, error: string) => void> {}
-
- interface VpnPacketReceptionEvent extends chrome.events.Event<(data:
ArrayBuffer) => void> {}
-
- interface VpnConfigRemovalEvent extends chrome.events.Event<(id:
string) => void> {}
-
- interface VpnConfigCreationEvent extends chrome.events.Event<(id:
string, name: string, data: Object) => void> {}
-
- interface VpnUiEvent extends chrome.events.Event<(event: string, id?:
string) => void> {}
-
- /**
- * Creates a new VPN configuration that persists across multiple login
sessions of the user.
- * @param name The name of the VPN configuration.
- * @param callback Called when the configuration is created or if there
is an error.
- * Parameter id: A unique ID for the created configuration, empty
string on failure.
- */
- export function createConfig(name: string, callback: (id: string) =>
void): void;
- /**
- * Destroys a VPN configuration created by the extension.
- * @param id ID of the VPN configuration to destroy.
- * @param callback Optional. Called when the configuration is destroyed
or if there is an error.
- */
- export function destroyConfig(id: string, callback?: Function): void;
- /**
- * Sets the parameters for the VPN session. This should be called
immediately after "connected" is received from the platform. This will succeed
only when the VPN session is owned by the extension.
- * @param parameters The parameters for the VPN session.
- * @param callback Called when the parameters are set or if there is an
error.
- */
- export function setParameters(parameters: VpnSessionParameters,
callback: Function): void;
- /**
- * Sends an IP packet through the tunnel created for the VPN session.
This will succeed only when the VPN session is owned by the extension.
- * @param data The IP packet to be sent to the platform.
- * @param callback Optional. Called when the packet is sent or if there
is an error.
- */
- export function sendPacket(data: ArrayBuffer, callback?: Function):
void;
- /**
- * Notifies the VPN session state to the platform. This will succeed
only when the VPN session is owned by the extension.
- * @param state The VPN session state of the VPN client.
- * connected: VPN connection was successful.
- * failure: VPN connection failed.
- * @param callback Optional. Called when the notification is complete
or if there is an error.
- */
- export function notifyConnectionStateChanged(state: string, callback?:
Function): void;
-
- /** Triggered when a message is received from the platform for a VPN
configuration owned by the extension. */
- var onPlatformMessage: VpnPlatformMessageEvent;
- /** Triggered when an IP packet is received via the tunnel for the VPN
session owned by the extension. */
- var onPacketReceived: VpnPacketReceptionEvent;
- /** Triggered when a configuration created by the extension is removed
by the platform. */
- var onConfigRemoved: VpnConfigRemovalEvent;
- /** Triggered when a configuration is created by the platform for the
extension. */
- var onConfigCreated: VpnConfigCreationEvent;
- /** Triggered when there is a UI event for the extension. UI events are
signals from the platform that indicate to the app that a UI dialog needs to be
shown to the user. */
- var onUIEvent: VpnUiEvent;
-}
-
-////////////////////
-// Wallpaper
-////////////////////
-/**
- * Use the chrome.wallpaper API to change the ChromeOS wallpaper.
- * Permissions: "wallpaper"
- * Important: This API works only on Chrome OS.
- * @since Chrome 43.
- */
-declare namespace chrome.wallpaper {
- interface WallpaperDetails {
- /** Optional. The jpeg or png encoded wallpaper image. */
- data?: any;
- /** Optional. The URL of the wallpaper to be set. */
- url?: string;
- /**
- * The supported wallpaper layouts.
- * One of: "STRETCH", "CENTER", or "CENTER_CROPPED"
- */
- layout: string;
- /** The file name of the saved wallpaper. */
- filename: string;
- /** Optional. True if a 128x60 thumbnail should be generated. */
- thumbnail?: boolean;
- }
-
- /**
- * Sets wallpaper to the image at url or wallpaperData with the
specified layout
- * @param callback
- * Optional parameter thumbnail: The jpeg encoded wallpaper thumbnail.
It is generated by resizing the wallpaper to 128x60.
- */
- export function setWallpaper(details: WallpaperDetails, callback:
(thumbnail: any) => void): void;
-}
-
-////////////////////
-// Web Navigation
-////////////////////
-/**
- * Use the chrome.webNavigation API to receive notifications about the status
of navigation requests in-flight.
- * Permissions: "webNavigation"
- * @since Chrome 16.
- */
-declare namespace chrome.webNavigation {
- interface GetFrameDetails {
- /**
- * The ID of the process runs the renderer for this tab.
- * @since Chrome 22.
- */
- processId: number;
- /** The ID of the tab in which the frame is. */
- tabId: number;
- /** The ID of the frame in the given tab. */
- frameId: number;
- }
-
- interface GetFrameResultDetails {
- /** The URL currently associated with this frame, if the frame
identified by the frameId existed at one point in the given tab. The fact that
an URL is associated with a given frameId does not imply that the corresponding
frame still exists. */
- url: string;
- /** True if the last navigation in this frame was interrupted
by an error, i.e. the onErrorOccurred event fired. */
- errorOccurred: boolean;
- /** ID of frame that wraps the frame. Set to -1 of no parent
frame exists. */
- parentFrameId: number;
- }
-
- interface GetAllFrameDetails {
- /** The ID of the tab. */
- tabId: number;
- }
-
- interface GetAllFrameResultDetails extends GetFrameResultDetails {
- /** The ID of the process runs the renderer for this tab. */
- processId: number;
- /** The ID of the frame. 0 indicates that this is the main
frame; a positive value indicates the ID of a subframe. */
- frameId: number;
- }
-
- interface WebNavigationCallbackDetails {
- /** The ID of the tab in which the navigation is about to
occur. */
- tabId: number;
- /** The time when the browser was about to start the
navigation, in milliseconds since the epoch. */
- timeStamp: number;
- }
-
- interface WebNavigationUrlCallbackDetails extends
WebNavigationCallbackDetails {
- url: string;
- }
-
- interface WebNavigationReplacementCallbackDetails extends
WebNavigationCallbackDetails {
- /** The ID of the tab that was replaced. */
- replacedTabId: number;
- }
-
- interface WebNavigationFramedCallbackDetails extends
WebNavigationUrlCallbackDetails {
- /** 0 indicates the navigation happens in the tab content
window; a positive value indicates navigation in a subframe. Frame IDs are
unique for a given tab and process. */
- frameId: number;
- /**
- * The ID of the process runs the renderer for this tab.
- * @since Chrome 22.
- */
- processId: number;
- }
-
- interface WebNavigationFramedErrorCallbackDetails extends
WebNavigationFramedCallbackDetails {
- /** The error description. */
- error: string;
- }
-
- interface WebNavigationSourceCallbackDetails extends
WebNavigationUrlCallbackDetails {
- /** The ID of the tab in which the navigation is triggered. */
- sourceTabId: number;
- /**
- * The ID of the process runs the renderer for the source tab.
- * @since Chrome 22.
- */
- sourceProcessId: number;
- /** The ID of the frame with sourceTabId in which the
navigation is triggered. 0 indicates the main frame. */
- sourceFrameId: number;
- }
-
- interface WebNavigationParentedCallbackDetails extends
WebNavigationFramedCallbackDetails {
- /**
- * ID of frame that wraps the frame. Set to -1 of no parent
frame exists.
- * @since Chrome 24.
- */
- parentFrameId: number;
- }
-
- interface WebNavigationTransitionCallbackDetails extends
WebNavigationFramedCallbackDetails {
- /**
- * Cause of the navigation.
- * One of: "link", "typed", "auto_bookmark", "auto_subframe",
"manual_subframe", "generated", "start_page", "form_submit", "reload",
"keyword", or "keyword_generated"
- */
- transitionType: string;
- /**
- * A list of transition qualifiers.
- * Each element one of: "client_redirect", "server_redirect",
"forward_back", or "from_address_bar"
- */
- transitionQualifiers: string[];
- }
-
- interface WebNavigationEventFilter {
- /** Conditions that the URL being navigated to must satisfy.
The 'schemes' and 'ports' fields of UrlFilter are ignored for this event. */
- url: chrome.events.UrlFilter[];
- }
-
- interface WebNavigationEvent<T extends WebNavigationCallbackDetails>
extends chrome.events.Event<(details: T) => void> {
- addListener(callback: (details: T) => void, filters?:
WebNavigationEventFilter): void;
- }
-
- interface WebNavigationFramedEvent extends
WebNavigationEvent<WebNavigationFramedCallbackDetails> {}
-
- interface WebNavigationFramedErrorEvent extends
WebNavigationEvent<WebNavigationFramedErrorCallbackDetails> {}
-
- interface WebNavigationSourceEvent extends
WebNavigationEvent<WebNavigationSourceCallbackDetails> {}
-
- interface WebNavigationParentedEvent extends
WebNavigationEvent<WebNavigationParentedCallbackDetails> {}
-
- interface WebNavigationTransitionalEvent extends
WebNavigationEvent<WebNavigationTransitionCallbackDetails> {}
-
- interface WebNavigationReplacementEvent extends
WebNavigationEvent<WebNavigationReplacementCallbackDetails> {}
-
- /**
- * Retrieves information about the given frame. A frame refers to an
<iframe> or a <frame> of a web page and is identified by a tab ID and a frame
ID.
- * @param details Information about the frame to retrieve information
about.
- * @param callback
- * Optional parameter details: Information about the requested frame,
null if the specified frame ID and/or tab ID are invalid.
- */
- export function getFrame(details: GetFrameDetails, callback: (details?:
GetFrameResultDetails) => void): void;
- /**
- * Retrieves information about all frames of a given tab.
- * @param details Information about the tab to retrieve all frames from.
- * @param callback
- * Optional parameter details: A list of frames in the given tab, null
if the specified tab ID is invalid.
- */
- export function getAllFrames(details: GetAllFrameDetails, callback:
(details?: GetAllFrameResultDetails[]) => void): void;
-
- /** Fired when the reference fragment of a frame was updated. All
future events for that frame will use the updated URL. */
- var onReferenceFragmentUpdated: WebNavigationTransitionalEvent;
- /** Fired when a document, including the resources it refers to, is
completely loaded and initialized. */
- var onCompleted: WebNavigationFramedEvent;
- /**
- * Fired when the frame's history was updated to a new URL. All future
events for that frame will use the updated URL.
- * @since Chrome 22.
- */
- var onHistoryStateUpdated: WebNavigationTransitionalEvent;
- /** Fired when a new window, or a new tab in an existing window, is
created to host a navigation. */
- var onCreatedNavigationTarget: WebNavigationSourceEvent;
- /**
- * Fired when the contents of the tab is replaced by a different
(usually previously pre-rendered) tab.
- * @since Chrome 22.
- */
- var onTabReplaced: WebNavigationReplacementEvent;
- /** Fired when a navigation is about to occur. */
- var onBeforeNavigate: WebNavigationParentedEvent;
- /** Fired when a navigation is committed. The document (and the
resources it refers to, such as images and subframes) might still be
downloading, but at least part of the document has been received from the
server and the browser has decided to switch to the new document. */
- var onCommitted: WebNavigationTransitionalEvent;
- /** Fired when the page's DOM is fully constructed, but the referenced
resources may not finish loading. */
- var onDOMContentLoaded: WebNavigationFramedEvent;
- /** Fired when an error occurs and the navigation is aborted. This can
happen if either a network error occurred, or the user aborted the navigation.
*/
- var onErrorOccurred: WebNavigationFramedErrorEvent;
-}
-
-////////////////////
-// Web Request
-////////////////////
-/**
- * Use the chrome.webRequest API to observe and analyze traffic and to
intercept, block, or modify requests in-flight.
- * Permissions: "webRequest", host permissions
- * @since Chrome 17.
- */
-declare namespace chrome.webRequest {
- interface AuthCredentials {
- username: string;
- password: string;
- }
-
- /** An HTTP Header, represented as an object containing a key and
either a value or a binaryValue. */
- interface HttpHeader {
- name: string;
- value?: string;
- binaryValue?: ArrayBuffer;
- }
-
- /** Returns value for event handlers that have the 'blocking'
extraInfoSpec applied. Allows the event handler to modify network requests. */
- interface BlockingResponse {
- /** Optional. If true, the request is cancelled. Used in
onBeforeRequest, this prevents the request from being sent. */
- cancel?: boolean;
- /**
- * Optional.
- * Only used as a response to the onBeforeRequest and
onHeadersReceived events. If set, the original request is prevented from being
sent/completed and is instead redirected to the given URL. Redirections to
non-HTTP schemes such as data: are allowed. Redirects initiated by a redirect
action use the original request method for the redirect, with one exception: If
the redirect is initiated at the onHeadersReceived stage, then the redirect
will be issued using the GET method.
- */
- redirectUrl?: string;
- /**
- * Optional.
- * Only used as a response to the onHeadersReceived event. If
set, the server is assumed to have responded with these response headers
instead. Only return responseHeaders if you really want to modify the headers
in order to limit the number of conflicts (only one extension may modify
responseHeaders for each request).
- */
- responseHeaders?: HttpHeader[];
- /** Optional. Only used as a response to the onAuthRequired
event. If set, the request is made using the supplied credentials. */
- authCredentials?: AuthCredentials;
- /**
- * Optional.
- * Only used as a response to the onBeforeSendHeaders event. If
set, the request is made with these request headers instead.
- */
- requestHeaders?: HttpHeader[];
- }
-
- /** An object describing filters to apply to webRequest events. */
- interface RequestFilter {
- /** Optional. */
- tabId?: number;
- /**
- * A list of request types. Requests that cannot match any of
the types will be filtered out.
- * Each element one of: "main_frame", "sub_frame",
"stylesheet", "script", "image", "object", "xmlhttprequest", or "other"
- */
- types?: string[];
- /** A list of URLs or URL patterns. Requests that cannot match
any of the URLs will be filtered out. */
- urls: string[];
- /** Optional. */
- windowId?: number;
- }
-
- /**
- * Contains data uploaded in a URL request.
- * @since Chrome 23.
- */
- interface UploadData {
- /** Optional. An ArrayBuffer with a copy of the data. */
- bytes?: ArrayBuffer;
- /** Optional. A string with the file's path and name. */
- file?: string;
- }
-
- interface WebRequestBody {
- /** Optional. Errors when obtaining request body data. */
- error?: string;
- /**
- * Optional.
- * If the request method is POST and the body is a sequence of
key-value pairs encoded in UTF8, encoded as either multipart/form-data, or
application/x-www-form-urlencoded, this dictionary is present and for each key
contains the list of all values for that key. If the data is of another media
type, or if it is malformed, the dictionary is not present. An example value of
this dictionary is {'key': ['value1', 'value2']}.
- */
- formData?: { [key: string]: string[] };
- /**
- * Optional.
- * If the request method is PUT or POST, and the body is not
already parsed in formData, then the unparsed request body elements are
contained in this array.
- */
- raw?: UploadData[];
- }
-
- interface WebAuthChallenger {
- host: string;
- port: number;
- }
-
- interface ResourceRequest {
- url: string;
- /** The ID of the request. Request IDs are unique within a
browser session. As a result, they could be used to relate different events of
the same request. */
- requestId: string;
- /** The value 0 indicates that the request happens in the main
frame; a positive value indicates the ID of a subframe in which the request
happens. If the document of a (sub-)frame is loaded (type is main_frame or
sub_frame), frameId indicates the ID of this frame, not the ID of the outer
frame. Frame IDs are unique within a tab. */
- frameId: number;
- /** ID of frame that wraps the frame which sent the request.
Set to -1 if no parent frame exists. */
- parentFrameId: number;
- /** The ID of the tab in which the request takes place. Set to
-1 if the request isn't related to a tab. */
- tabId: number;
- /**
- * How the requested resource will be used.
- * One of: "main_frame", "sub_frame", "stylesheet", "script",
"image", "object", "xmlhttprequest", or "other"
- */
- type: string;
- /** The time when this signal is triggered, in milliseconds
since the epoch. */
- timeStamp: number;
- }
-
- interface WebRequestDetails extends ResourceRequest {
- /** Standard HTTP method. */
- method: string;
- }
-
- interface WebRequestHeadersDetails extends WebRequestDetails {
- /** Optional. The HTTP request headers that are going to be
sent out with this request. */
- requestHeaders?: HttpHeader[];
- }
-
- interface WebRequestBodyDetails extends WebRequestDetails {
- /**
- * Contains the HTTP request body data. Only provided if
extraInfoSpec contains 'requestBody'.
- * @since Chrome 23.
- */
- requestBody: WebRequestBody;
- }
-
- interface WebRequestFullDetails extends WebRequestHeadersDetails,
WebRequestBodyDetails {
- }
-
- interface WebResponseDetails extends ResourceRequest {
- /** HTTP status line of the response or the 'HTTP/0.9 200 OK'
string for HTTP/0.9 responses (i.e., responses that lack a status line). */
- statusLine: string;
- /**
- * Standard HTTP status code returned by the server.
- * @since Chrome 43.
- */
- statusCode: number;
- }
-
- interface WebResponseHeadersDetails extends WebResponseDetails {
- /** Optional. The HTTP response headers that have been received
with this response. */
- responseHeaders?: HttpHeader[];
- }
-
- interface WebResponseCacheDetails extends WebResponseHeadersDetails {
- /**
- * Optional.
- * The server IP address that the request was actually sent to.
Note that it may be a literal IPv6 address.
- */
- ip?: string;
- /** Indicates if this response was fetched from disk cache. */
- fromCache: boolean;
- }
-
- interface WebRedirectionResponseDetails extends WebResponseCacheDetails
{
- /** The new URL. */
- redirectUrl: string;
- }
-
- interface WebAuthenticationChallengeDetails extends
WebResponseHeadersDetails {
- /** The authentication scheme, e.g. Basic or Digest. */
- scheme: string;
- /** The authentication realm provided by the server, if there
is one. */
- realm?: string;
- /** The server requesting authentication. */
- challenger: WebAuthChallenger;
- /** True for Proxy-Authenticate, false for WWW-Authenticate. */
- isProxy: boolean;
- }
-
- interface WebResponseErrorDetails extends WebResponseCacheDetails {
- /** The error description. This string is not guaranteed to
remain backwards compatible between releases. You must not parse and act based
upon its content. */
- error: string;
- }
-
- interface WebRequestBodyEvent extends chrome.events.Event<(details:
WebRequestBodyDetails) => void> {
- addListener(callback: (details: WebRequestBodyDetails) => void,
filter?: RequestFilter, opt_extraInfoSpec?: string[]): void;
- }
-
- interface WebRequestHeadersEvent extends chrome.events.Event<(details:
WebRequestHeadersDetails) => void> {
- addListener(callback: (details: WebRequestHeadersDetails) =>
void, filter?: RequestFilter, opt_extraInfoSpec?: string[]): void;
- }
-
- interface _WebResponseHeadersEvent<T extends WebResponseHeadersDetails>
extends chrome.events.Event<(details: T) => void> {
- addListener(callback: (details: T) => void, filter?:
RequestFilter, opt_extraInfoSpec?: string[]): void;
- }
-
- interface WebResponseHeadersEvent extends
_WebResponseHeadersEvent<WebResponseHeadersDetails> {}
-
- interface WebResponseCacheEvent extends
_WebResponseHeadersEvent<WebResponseCacheDetails> {}
-
- interface WebRedirectionResponseEvent extends
_WebResponseHeadersEvent<WebRedirectionResponseDetails> {}
-
- interface WebAuthenticationChallengeEvent extends
chrome.events.Event<(details: WebAuthenticationChallengeDetails, callback?:
(response: BlockingResponse) => void) => void> {
- addListener(callback: (details:
WebAuthenticationChallengeDetails) => void, filter?: RequestFilter,
opt_extraInfoSpec?: string[]): void;
- }
-
- interface WebResponseErrorEvent extends
_WebResponseHeadersEvent<WebResponseErrorDetails> {}
-
- /**
- * The maximum number of times that handlerBehaviorChanged can be
called per 10 minute sustained interval. handlerBehaviorChanged is an expensive
function call that shouldn't be called often.
- * @since Chrome 23.
- */
- var MAX_HANDLER_BEHAVIOR_CHANGED_CALLS_PER_10_MINUTES: number;
-
- /** Needs to be called when the behavior of the webRequest handlers has
changed to prevent incorrect handling due to caching. This function call is
expensive. Don't call it often. */
- export function handlerBehaviorChanged(callback?: Function): void;
-
- /** Fired when a request is about to occur. */
- var onBeforeRequest: WebRequestBodyEvent;
- /** Fired before sending an HTTP request, once the request headers are
available. This may occur after a TCP connection is made to the server, but
before any HTTP data is sent. */
- var onBeforeSendHeaders: WebRequestHeadersEvent;
- /** Fired just before a request is going to be sent to the server
(modifications of previous onBeforeSendHeaders callbacks are visible by the
time onSendHeaders is fired). */
- var onSendHeaders: WebRequestHeadersEvent;
- /** Fired when HTTP response headers of a request have been received. */
- var onHeadersReceived: WebResponseHeadersEvent;
- /** Fired when an authentication failure is received. The listener has
three options: it can provide authentication credentials, it can cancel the
request and display the error page, or it can take no action on the challenge.
If bad user credentials are provided, this may be called multiple times for the
same request. */
- var onAuthRequired: WebAuthenticationChallengeEvent;
- /** Fired when the first byte of the response body is received. For
HTTP requests, this means that the status line and response headers are
available. */
- var onResponseStarted: WebResponseCacheEvent;
- /** Fired when a server-initiated redirect is about to occur. */
- var onBeforeRedirect: WebRedirectionResponseEvent;
- /** Fired when a request is completed. */
- var onCompleted: WebResponseCacheEvent;
- /** Fired when an error occurs. */
- var onErrorOccurred: WebResponseErrorEvent;
-}
-
-////////////////////
-// Web Store
-////////////////////
-/**
- * Use the chrome.webstore API to initiate app and extension installations
"inline" from your site.
- * @since Chrome 15.
- */
-declare namespace chrome.webstore {
- /**
- * @param url Optional. If you have more than one <link> tag on your
page with the chrome-webstore-item relation, you can choose which item you'd
like to install by passing in its URL here. If it is omitted, then the first
(or only) link will be used. An exception will be thrown if the passed in URL
does not exist on the page.
- * @param successCallback Optional. This function is invoked when
inline installation successfully completes (after the dialog is shown and the
user agrees to add the item to Chrome). You may wish to use this to hide the
user interface element that prompted the user to install the app or extension.
- * @param failureCallback Optional. This function is invoked when
inline installation does not successfully complete. Possible reasons for this
include the user canceling the dialog, the linked item not being found in the
store, or the install being initiated from a non-verified site.
- * Parameter error: The failure detail. You may wish to inspect or log
this for debugging purposes, but you should not rely on specific strings being
passed back.
- * Optional parameter errorCode: The error code from the stable set of
possible errors.
- * * Enum of the possible install results, including error codes sent
back in the event that an inline installation has failed.
- * * * "otherError": An uncommon, unrecognized, or unexpected error. In
some cases, the readable error string can provide more information.
- * * * "aborted": The operation was aborted as the requestor is no
longer alive.
- * * * "installInProgress": An installation of the same extension is in
progress.
- * * * "notPermitted": The installation is not permitted.
- * * * "invalidId": Invalid Chrome Web Store item ID.
- * * * "webstoreRequestError": Failed to retrieve extension metadata
from the Web Store.
- * * * "invalidWebstoreResponse": The extension metadata retrieved from
the Web Store was invalid.
- * * * "invalidManifest": An error occurred while parsing the extension
manifest retrieved from the Web Store.
- * * * "iconError": Failed to retrieve the extension's icon from the
Web Store, or the icon was invalid.
- * * * "userCanceled": The user canceled the operation.
- * * * "blacklisted": The extension is blacklisted.
- * * * "missingDependencies": Unsatisfied dependencies, such as shared
modules.
- * * * "requirementViolations": Unsatisfied requirements, such as webgl.
- * * * "blockedByPolicy": The extension is blocked by management
policies.
- * * * "launchFeatureDisabled": The launch feature is not available.
- * * * "launchUnsupportedExtensionType": The launch feature is not
supported for the extension type.
- * * * "launchInProgress": A launch of the same extension is in
progress.
- */
- export function install(url: string, successCallback?: Function,
failureCallback?: (error: string, errorCode?: string) => void): void;
- /**
- * @param successCallback Optional. This function is invoked when
inline installation successfully completes (after the dialog is shown and the
user agrees to add the item to Chrome). You may wish to use this to hide the
user interface element that prompted the user to install the app or extension.
- * @param failureCallback Optional. This function is invoked when
inline installation does not successfully complete. Possible reasons for this
include the user canceling the dialog, the linked item not being found in the
store, or the install being initiated from a non-verified site.
- * Parameter error: The failure detail. You may wish to inspect or log
this for debugging purposes, but you should not rely on specific strings being
passed back.
- * Optional parameter errorCode: The error code from the stable set of
possible errors.
- * * Enum of the possible install results, including error codes sent
back in the event that an inline installation has failed.
- * * * "otherError": An uncommon, unrecognized, or unexpected error. In
some cases, the readable error string can provide more information.
- * * * "aborted": The operation was aborted as the requestor is no
longer alive.
- * * * "installInProgress": An installation of the same extension is in
progress.
- * * * "notPermitted": The installation is not permitted.
- * * * "invalidId": Invalid Chrome Web Store item ID.
- * * * "webstoreRequestError": Failed to retrieve extension metadata
from the Web Store.
- * * * "invalidWebstoreResponse": The extension metadata retrieved from
the Web Store was invalid.
- * * * "invalidManifest": An error occurred while parsing the extension
manifest retrieved from the Web Store.
- * * * "iconError": Failed to retrieve the extension's icon from the
Web Store, or the icon was invalid.
- * * * "userCanceled": The user canceled the operation.
- * * * "blacklisted": The extension is blacklisted.
- * * * "missingDependencies": Unsatisfied dependencies, such as shared
modules.
- * * * "requirementViolations": Unsatisfied requirements, such as webgl.
- * * * "blockedByPolicy": The extension is blocked by management
policies.
- * * * "launchFeatureDisabled": The launch feature is not available.
- * * * "launchUnsupportedExtensionType": The launch feature is not
supported for the extension type.
- * * * "launchInProgress": A launch of the same extension is in
progress.
- */
- export function install(successCallback: Function, failureCallback?:
(error: string, errorCode?: string) => void): void;
- /**
- * @param failureCallback Optional. This function is invoked when
inline installation does not successfully complete. Possible reasons for this
include the user canceling the dialog, the linked item not being found in the
store, or the install being initiated from a non-verified site.
- * Parameter error: The failure detail. You may wish to inspect or log
this for debugging purposes, but you should not rely on specific strings being
passed back.
- * Optional parameter errorCode: The error code from the stable set of
possible errors.
- * * Enum of the possible install results, including error codes sent
back in the event that an inline installation has failed.
- * * * "otherError": An uncommon, unrecognized, or unexpected error. In
some cases, the readable error string can provide more information.
- * * * "aborted": The operation was aborted as the requestor is no
longer alive.
- * * * "installInProgress": An installation of the same extension is in
progress.
- * * * "notPermitted": The installation is not permitted.
- * * * "invalidId": Invalid Chrome Web Store item ID.
- * * * "webstoreRequestError": Failed to retrieve extension metadata
from the Web Store.
- * * * "invalidWebstoreResponse": The extension metadata retrieved from
the Web Store was invalid.
- * * * "invalidManifest": An error occurred while parsing the extension
manifest retrieved from the Web Store.
- * * * "iconError": Failed to retrieve the extension's icon from the
Web Store, or the icon was invalid.
- * * * "userCanceled": The user canceled the operation.
- * * * "blacklisted": The extension is blacklisted.
- * * * "missingDependencies": Unsatisfied dependencies, such as shared
modules.
- * * * "requirementViolations": Unsatisfied requirements, such as webgl.
- * * * "blockedByPolicy": The extension is blocked by management
policies.
- * * * "launchFeatureDisabled": The launch feature is not available.
- * * * "launchUnsupportedExtensionType": The launch feature is not
supported for the extension type.
- * * * "launchInProgress": A launch of the same extension is in
progress.
- */
- export function install(failureCallback?: (error: string, errorCode?:
string) => void): void;
-
- interface InstallationStageEvent extends chrome.events.Event<(stage:
string) => void> {}
-
- interface DownloadProgressEvent extends
chrome.events.Event<(percentDownloaded: number) => void> {}
-
- /**
- * Fired when an inline installation enters a new InstallStage. In
order to receive notifications about this event, listeners must be registered
before the inline installation begins.
- * @since Chrome 35.
- */
- var onInstallStageChanged: InstallationStageEvent;
- /**
- * Fired periodically with the download progress of an inline install.
In order to receive notifications about this event, listeners must be
registered before the inline installation begins.
- * @since Chrome 35.
- */
- var onDownloadProgress: DownloadProgressEvent;
-}
-
-////////////////////
-// Windows
-////////////////////
-/**
- * Use the chrome.windows API to interact with browser windows. You can use
this API to create, modify, and rearrange windows in the browser.
- * Permissions: The chrome.windows API can be used without declaring any
permission. However, the "tabs" permission is required in order to populate the
url, title, and favIconUrl properties of Tab objects.
- * @since Chrome 5.
- */
-declare namespace chrome.windows {
- interface Window {
- /** Array of tabs.Tab objects representing the current tabs in
the window. */
- tabs?: chrome.tabs.Tab[];
- /** Optional. The offset of the window from the top edge of the
screen in pixels. Under some circumstances a Window may not be assigned top
property, for example when querying closed windows from the sessions API. */
- top?: number;
- /** Optional. The height of the window, including the frame, in
pixels. Under some circumstances a Window may not be assigned height property,
for example when querying closed windows from the sessions API. */
- height?: number;
- /** Optional. The width of the window, including the frame, in
pixels. Under some circumstances a Window may not be assigned width property,
for example when querying closed windows from the sessions API. */
- width?: number;
- /**
- * The state of this browser window.
- * One of: "normal", "minimized", "maximized", "fullscreen", or
"docked"
- * @since Chrome 17.
- */
- state: string;
- /** Whether the window is currently the focused window. */
- focused: boolean;
- /**
- * Whether the window is set to be always on top.
- * @since Chrome 19.
- */
- alwaysOnTop: boolean;
- /** Whether the window is incognito. */
- incognito: boolean;
- /**
- * The type of browser window this is.
- * One of: "normal", "popup", "panel", "app", or "devtools"
- */
- type: string;
- /** Optional. The ID of the window. Window IDs are unique
within a browser session. Under some circumstances a Window may not be assigned
an ID, for example when querying windows using the sessions API, in which case
a session ID may be present. */
- id: number;
- /** Optional. The offset of the window from the left edge of
the screen in pixels. Under some circumstances a Window may not be assigned
left property, for example when querying closed windows from the sessions API.
*/
- left?: number;
- /**
- * The session ID used to uniquely identify a Window obtained
from the sessions API.
- * @since Chrome 31.
- */
- sessionId?: string;
- }
-
- interface GetInfo {
- /**
- * Optional.
- * If true, the windows.Window object will have a tabs property
that contains a list of the tabs.Tab objects. The Tab objects only contain the
url, title and favIconUrl properties if the extension's manifest file includes
the "tabs" permission.
- */
- populate?: boolean;
- /**
- * If set, the windows.Window returned will be filtered based
on its type. If unset the default filter is set to ['app', 'normal', 'panel',
'popup'], with 'app' and 'panel' window types limited to the extension's own
windows.
- * Each one of: "normal", "popup", "panel", "app", or "devtools"
- * @since Chrome 46. Warning: this is the current Beta channel.
- */
- windowTypes?: string[];
- }
-
- interface CreateData {
- /**
- * Optional. The id of the tab for which you want to adopt to
the new window.
- * @since Chrome 10.
- */
- tabId?: number;
- /**
- * Optional.
- * A URL or array of URLs to open as tabs in the window.
Fully-qualified URLs must include a scheme (i.e. 'http://www.google.com', not
'www.google.com'). Relative URLs will be relative to the current page within
the extension. Defaults to the New Tab Page.
- */
- url?: string | string[];
- /**
- * Optional.
- * The number of pixels to position the new window from the top
edge of the screen. If not specified, the new window is offset naturally from
the last focused window. This value is ignored for panels.
- */
- top?: number;
- /**
- * Optional.
- * The height in pixels of the new window, including the frame.
If not specified defaults to a natural height.
- */
- height?: number;
- /**
- * Optional.
- * The width in pixels of the new window, including the frame.
If not specified defaults to a natural width.
- */
- width?: number;
- /**
- * Optional. If true, opens an active window. If false, opens
an inactive window.
- * @since Chrome 12.
- */
- focused?: boolean;
- /** Optional. Whether the new window should be an incognito
window. */
- incognito?: boolean;
- /**
- * Optional. Specifies what type of browser window to create.
The 'panel' and 'detached_panel' types create a popup unless the
'--enable-panels' flag is set.
- * One of: "normal", "popup", "panel", or "detached_panel"
- */
- type?: string;
- /**
- * Optional.
- * The number of pixels to position the new window from the
left edge of the screen. If not specified, the new window is offset naturally
from the last focused window. This value is ignored for panels.
- */
- left?: number;
- /**
- * Optional. The initial state of the window. The 'minimized',
'maximized' and 'fullscreen' states cannot be combined with 'left', 'top',
'width' or 'height'.
- * One of: "normal", "minimized", "maximized", "fullscreen", or
"docked"
- * @since Chrome 44.
- */
- state?: string;
- }
-
- interface UpdateInfo {
- /** Optional. The offset from the top edge of the screen to
move the window to in pixels. This value is ignored for panels. */
- top?: number;
- /**
- * Optional. If true, causes the window to be displayed in a
manner that draws the user's attention to the window, without changing the
focused window. The effect lasts until the user changes focus to the window.
This option has no effect if the window already has focus. Set to false to
cancel a previous draw attention request.
- * @since Chrome 14.
- */
- drawAttention?: boolean;
- /** Optional. The height to resize the window to in pixels.
This value is ignored for panels. */
- height?: number;
- /** Optional. The width to resize the window to in pixels. This
value is ignored for panels. */
- width?: number;
- /**
- * Optional. The new state of the window. The 'minimized',
'maximized' and 'fullscreen' states cannot be combined with 'left', 'top',
'width' or 'height'.
- * One of: "normal", "minimized", "maximized", "fullscreen", or
"docked"
- * @since Chrome 17.
- */
- state?: string;
- /**
- * Optional. If true, brings the window to the front. If false,
brings the next window in the z-order to the front.
- * @since Chrome 8.
- */
- focused?: boolean;
- /** Optional. The offset from the left edge of the screen to
move the window to in pixels. This value is ignored for panels. */
- left?: number;
- }
-
- interface WindowEventFilter {
- /**
- * Conditions that the window's type being created must
satisfy. By default it will satisfy ['app', 'normal', 'panel', 'popup'], with
'app' and 'panel' window types limited to the extension's own windows.
- * Each one of: "normal", "popup", "panel", "app", or "devtools"
- */
- windowTypes: string[];
- }
-
- interface WindowIdEvent extends chrome.events.Event<(windowId: number,
filters?: WindowEventFilter) => void> {}
-
- interface WindowReferenceEvent extends chrome.events.Event<(window:
Window, filters?: WindowEventFilter) => void> {}
-
- /**
- * The windowId value that represents the current window.
- * @since Chrome 18.
- */
- var WINDOW_ID_CURRENT: number;
- /**
- * The windowId value that represents the absence of a chrome browser
window.
- * @since Chrome 6.
- */
- var WINDOW_ID_NONE: number;
-
- /** Gets details about a window. */
- export function get(windowId: number, callback: (window:
chrome.windows.Window) => void): void;
- /**
- * Gets details about a window.
- * @since Chrome 18.
- */
- export function get(windowId: number, getInfo: GetInfo, callback: (window:
chrome.windows.Window) => void): void;
- /**
- * Gets the current window.
- */
- export function getCurrent(callback: (window: chrome.windows.Window) =>
void): void;
- /**
- * Gets the current window.
- * @since Chrome 18.
- */
- export function getCurrent(getInfo: GetInfo, callback: (window:
chrome.windows.Window) => void): void;
- /**
- * Creates (opens) a new browser with any optional sizing, position or
default URL provided.
- * @param callback
- * Optional parameter window: Contains details about the created window.
- */
- export function create(callback?: (window?: chrome.windows.Window) =>
void): void;
- /**
- * Creates (opens) a new browser with any optional sizing, position or
default URL provided.
- * @param callback
- * Optional parameter window: Contains details about the created window.
- */
- export function create(createData: CreateData, callback?: (window?:
chrome.windows.Window) => void): void;
- /**
- * Gets all windows.
- */
- export function getAll(callback: (windows: chrome.windows.Window[]) =>
void): void;
- /**
- * Gets all windows.
- * @since Chrome 18.
- */
- export function getAll(getInfo: GetInfo, callback: (windows:
chrome.windows.Window[]) => void): void;
- /** Updates the properties of a window. Specify only the properties
that you want to change; unspecified properties will be left unchanged. */
- export function update(windowId: number, updateInfo: UpdateInfo,
callback?: (window: chrome.windows.Window) => void): void;
- /** Removes (closes) a window, and all the tabs inside it. */
- export function remove(windowId: number, callback?: Function): void;
- /**
- * Gets the window that was most recently focused — typically the
window 'on top'.
- */
- export function getLastFocused(callback: (window: chrome.windows.Window)
=> void): void;
- /**
- * Gets the window that was most recently focused — typically the
window 'on top'.
- * @since Chrome 18.
- */
- export function getLastFocused(getInfo: GetInfo, callback: (window:
chrome.windows.Window) => void): void;
-
- /** Fired when a window is removed (closed). */
- var onRemoved: WindowIdEvent;
- /** Fired when a window is created. */
- var onCreated: WindowReferenceEvent;
- /**
- * Fired when the currently focused window changes. Will be
chrome.windows.WINDOW_ID_NONE if all chrome windows have lost focus.
- * Note: On some Linux window managers, WINDOW_ID_NONE will always be
sent immediately preceding a switch from one chrome window to another.
- */
- var onFocusChanged: WindowIdEvent;
-}
diff --git a/decl/filesystem/filesystem.d.ts b/decl/filesystem/filesystem.d.ts
deleted file mode 100644
index 1b76846b..00000000
--- a/decl/filesystem/filesystem.d.ts
+++ /dev/null
@@ -1,548 +0,0 @@
-// Type definitions for File System API
-// Project: http://www.w3.org/TR/file-system-api/
-// Definitions by: Kon <http://phyzkit.net/>
-// Definitions: https://github.com/borisyankov/DefinitelyTyped
-
-/// <reference path="../filewriter/filewriter.d.ts" />
-
-interface LocalFileSystem {
-
- /**
- * Used for storage with no guarantee of persistence.
- */
- TEMPORARY:number;
-
- /**
- * Used for storage that should not be removed by the user agent without
application or user permission.
- */
- PERSISTENT:number;
-
- /**
- * Requests a filesystem in which to store application data.
- * @param type Whether the filesystem requested should be persistent, as
defined above. Use one of TEMPORARY or PERSISTENT.
- * @param size This is an indicator of how much storage space, in bytes,
the application expects to need.
- * @param successCallback The callback that is called when the user agent
provides a filesystem.
- * @param errorCallback A callback that is called when errors happen, or
when the request to obtain the filesystem is denied.
- */
- requestFileSystem(type:number, size:number,
successCallback:FileSystemCallback, errorCallback?:ErrorCallback):void;
-
- /**
- * Allows the user to look up the Entry for a file or directory referred
to by a local URL.
- * @param url A URL referring to a local file in a filesystem accessable
via this API.
- * @param successCallback A callback that is called to report the Entry to
which the supplied URL refers.
- * @param errorCallback A callback that is called when errors happen, or
when the request to obtain the Entry is denied.
- */
- resolveLocalFileSystemURL(url:string, successCallback:EntryCallback,
errorCallback?:ErrorCallback):void;
-
- /**
- * see requestFileSystem.
- */
- webkitRequestFileSystem(type:number, size:number,
successCallback:FileSystemCallback, errorCallback?:ErrorCallback):void;
-}
-
-interface LocalFileSystemSync {
- /**
- * Used for storage with no guarantee of persistence.
- */
- TEMPORARY:number;
-
- /**
- * Used for storage that should not be removed by the user agent without
application or user permission.
- */
- PERSISTENT:number;
-
- /**
- * Requests a filesystem in which to store application data.
- * @param type Whether the filesystem requested should be persistent, as
defined above. Use one of TEMPORARY or PERSISTENT.
- * @param size This is an indicator of how much storage space, in bytes,
the application expects to need.
- */
- requestFileSystemSync(type:number, size:number):FileSystemSync;
-
- /**
- * Allows the user to look up the Entry for a file or directory referred
to by a local URL.
- * @param url A URL referring to a local file in a filesystem accessable
via this API.
- */
- resolveLocalFileSystemSyncURL(url:string):EntrySync;
-
- /**
- * see requestFileSystemSync
- */
- webkitRequestFileSystemSync(type:number, size:number):FileSystemSync;
-}
-
-interface Metadata {
- /**
- * This is the time at which the file or directory was last modified.
- * @readonly
- */
- modificationTime:Date;
-
- /**
- * The size of the file, in bytes. This must return 0 for directories.
- * @readonly
- */
- size:number;
-}
-
-interface Flags {
- /**
- * Used to indicate that the user wants to create a file or directory if
it was not previously there.
- */
- create?:boolean;
-
- /**
- * By itself, exclusive must have no effect. Used with create, it must
cause getFile and getDirectory to fail if the target path already exists.
- */
- exclusive?:boolean;
-}
-
-/**
- * This interface represents a file system.
- */
-interface FileSystem{
- /**
- * This is the name of the file system. The specifics of naming
filesystems is unspecified, but a name must be unique across the list of
exposed file systems.
- * @readonly
- */
- name: string;
-
- /**
- * The root directory of the file system.
- * @readonly
- */
- root: DirectoryEntry;
-}
-
-interface Entry {
-
- /**
- * Entry is a file.
- */
- isFile:boolean;
-
- /**
- * Entry is a directory.
- */
- isDirectory:boolean;
-
- /**
- * Look up metadata about this entry.
- * @param successCallback A callback that is called with the time of the
last modification.
- * @param errorCallback ErrorCallback A callback that is called when
errors happen.
- */
- getMetadata(successCallback:MetadataCallback,
errorCallback?:ErrorCallback):void;
-
- /**
- * The name of the entry, excluding the path leading to it.
- */
- name:string;
-
- /**
- * The full absolute path from the root to the entry.
- */
- fullPath:string;
-
- /**
- * The file system on which the entry resides.
- */
- filesystem:FileSystem;
-
- /**
- * Move an entry to a different location on the file system. It is an
error to try to:
- *
- * <ui>
- * <li>move a directory inside itself or to any child at any depth;</li>
- * <li>move an entry into its parent if a name different from its current
one isn't provided;</li>
- * <li>move a file to a path occupied by a directory;</li>
- * <li>move a directory to a path occupied by a file;</li>
- * <li>move any element to a path occupied by a directory which is not
empty.</li>
- * <ul>
- *
- * A move of a file on top of an existing file must attempt to delete and
replace that file.
- * A move of a directory on top of an existing empty directory must
attempt to delete and replace that directory.
- */
- moveTo(parent:DirectoryEntry, newName?:string,
successCallback?:EntryCallback, errorCallback?:ErrorCallback):string;
-
- /**
- * Copy an entry to a different location on the file system. It is an
error to try to:
- *
- * <ul>
- * <li> copy a directory inside itself or to any child at any depth;</li>
- * <li> copy an entry into its parent if a name different from its current
one isn't provided;</li>
- * <li> copy a file to a path occupied by a directory;</li>
- * <li> copy a directory to a path occupied by a file;</li>
- * <li> copy any element to a path occupied by a directory which is not
empty.</li>
- * <li> A copy of a file on top of an existing file must attempt to delete
and replace that file.</li>
- * <li> A copy of a directory on top of an existing empty directory must
attempt to delete and replace that directory.</li>
- * </ul>
- *
- * Directory copies are always recursive--that is, they copy all contents
of the directory.
- */
- copyTo(parent:DirectoryEntry, newName?:string,
successCallback?:EntryCallback, errorCallback?:ErrorCallback):string;
-
- /**
- * Returns a URL that can be used to identify this entry. Unlike the URN
defined in [FILE-API-ED], it has no specific expiration; as it describes a
location on disk, it should be valid at least as long as that location exists.
- */
- toURL():string;
-
- /**
- * Deletes a file or directory. It is an error to attempt to delete a
directory that is not empty. It is an error to attempt to delete the root
directory of a filesystem.
- * @param successCallback A callback that is called on success.
- * @param errorCallback A callback that is called when errors happen.
- */
- remove(successCallback:VoidCallback, errorCallback?:ErrorCallback):void;
-
- /**
- * Look up the parent DirectoryEntry containing this Entry. If this Entry
is the root of its filesystem, its parent is itself.
- * @param successCallback A callback that is called to return the parent
Entry.
- * @param errorCallback A callback that is called when errors happen.
- */
- getParent(successCallback:DirectoryEntryCallback,
errorCallback?:ErrorCallback):void;
-}
-
-/**
- * This interface represents a directory on a file system.
- */
-interface DirectoryEntry extends Entry {
- /**
- * Creates a new DirectoryReader to read Entries from this Directory.
- */
- createReader():DirectoryReader;
-
- /**
- * Creates or looks up a file.
- * @param path Either an absolute path or a relative path from this
DirectoryEntry to the file to be looked up or created. It is an error to
attempt to create a file whose immediate parent does not yet exist.
- * @param options
- * <ul>
- * <li>If create and exclusive are both true, and the path already
exists, getFile must fail.</li>
- * <li>If create is true, the path doesn't exist, and no other error
occurs, getFile must create it as a zero-length file and return a corresponding
FileEntry.</li>
- * <li>If create is not true and the path doesn't exist, getFile must
fail.</li>
- * <li>If create is not true and the path exists, but is a directory,
getFile must fail.</li>
- * <li>Otherwise, if no other error occurs, getFile must return a
FileEntry corresponding to path.</li>
- * </ul>
- * @param successCallback A callback that is called to return the File
selected or created.
- * @param errorCallback A callback that is called when errors happen.
- */
- getFile(path:string, options?:Flags, successCallback?:FileEntryCallback,
errorCallback?:ErrorCallback):void;
-
- /**
- * Creates or looks up a directory.
- * @param path Either an absolute path or a relative path from this
DirectoryEntry to the directory to be looked up or created. It is an error to
attempt to create a directory whose immediate parent does not yet exist.
- * @param options
- * <ul>
- * <li>If create and exclusive are both true and the path already
exists, getDirectory must fail.</li>
- * <li>If create is true, the path doesn't exist, and no other error
occurs, getDirectory must create and return a corresponding DirectoryEntry.</li>
- * <li>If create is not true and the path doesn't exist, getDirectory
must fail.</li>
- * <li>If create is not true and the path exists, but is a file,
getDirectory must fail.</li>
- * <li>Otherwise, if no other error occurs, getDirectory must return a
DirectoryEntry corresponding to path.</li>
- * </ul>
- * @param successCallback A callback that is called to return the
DirectoryEntry selected or created.
- * @param errorCallback A callback that is called when errors happen.
- *
- */
- getDirectory(path:string, options?:Flags,
successCallback?:DirectoryEntryCallback, errorCallback?:ErrorCallback):void;
-
- /**
- * Deletes a directory and all of its contents, if any. In the event of an
error [e.g. trying to delete a directory that contains a file that cannot be
removed], some of the contents of the directory may be deleted. It is an error
to attempt to delete the root directory of a filesystem.
- * @param successCallback A callback that is called on success.
- * @param errorCallback A callback that is called when errors happen.
- */
- removeRecursively(successCallback:VoidCallback,
errorCallback?:ErrorCallback):void;
-}
-
-/**
- * This interface lets a user list files and directories in a directory. If
there are no additions to or deletions from a directory between the first and
last call to readEntries, and no errors occur, then:
- * <ul>
- * <li> A series of calls to readEntries must return each entry in the
directory exactly once.</li>
- * <li> Once all entries have been returned, the next call to readEntries must
produce an empty array.</li>
- * <li> If not all entries have been returned, the array produced by
readEntries must not be empty.</li>
- * <li> The entries produced by readEntries must not include the directory
itself ["."] or its parent [".."].</li>
- * </ul>
- */
-interface DirectoryReader {
- /**
- * Read the next block of entries from this directory.
- * @param successCallback Called once per successful call to readEntries
to deliver the next previously-unreported set of Entries in the associated
Directory. If all Entries have already been returned from previous invocations
of readEntries, successCallback must be called with a zero-length array as an
argument.
- * @param errorCallback A callback indicating that there was an error
reading from the Directory.
- */
- readEntries(successCallback:EntriesCallback,
errorCallback?:ErrorCallback):void;
-}
-
-/**
- * This interface represents a file on a file system.
- */
-interface FileEntry extends Entry {
- /**
- * Creates a new FileWriter associated with the file that this FileEntry
represents.
- * @param successCallback A callback that is called with the new
FileWriter.
- * @param errorCallback A callback that is called when errors happen.
- */
- createWriter(successCallback:FileWriterCallback,
errorCallback?:ErrorCallback):void;
-
- /**
- * Returns a File that represents the current state of the file that this
FileEntry represents.
- * @param successCallback A callback that is called with the File.
- * @param errorCallback A callback that is called when errors happen.
- */
- file(successCallback:FileCallback, errorCallback?:ErrorCallback):void;
-}
-
-/**
- * When requestFileSystem() succeeds, the following callback is made.
- */
-interface FileSystemCallback {
- /**
- * @param filesystem The file systems to which the app is granted access.
- */
- (filesystem:FileSystem):void;
-}
-
-/**
- * This interface is the callback used to look up Entry objects.
- */
-interface EntryCallback {
- /**
- * @param entry
- */
- (entry:Entry):void;
-}
-
-/**
- * This interface is the callback used to look up FileEntry objects.
- */
-interface FileEntryCallback {
- /**
- * @param entry
- */
- (entry:FileEntry):void;
-}
-
-/**
- * This interface is the callback used to look up DirectoryEntry objects.
- */
-interface DirectoryEntryCallback {
- /**
- * @param entry
- */
- (entry:DirectoryEntry):void;
-}
-
-/**
- * When readEntries() succeeds, the following callback is made.
- */
-interface EntriesCallback {
- (entries:Entry[]):void;
-}
-
-/**
- * This interface is the callback used to look up file and directory metadata.
- */
-interface MetadataCallback {
- (metadata:Metadata):void;
-}
-
-/**
- * This interface is the callback used to create a FileWriter.
- */
-interface FileWriterCallback {
- (fileWriter:FileWriter):void;
-}
-
-/**
- * This interface is the callback used to obtain a File.
- */
-interface FileCallback {
- (file:File):void;
-}
-
-/**
- * This interface is the generic callback used to indicate success of an
asynchronous method.
- */
-interface VoidCallback {
- ():void;
-}
-
-/**
- * When an error occurs, the following callback is made.
- */
-interface ErrorCallback {
- (err:DOMError):void;
-}
-
-
-/**
- * This interface represents a file system.
- */
-interface FileSystemSync {
- /**
- * This is the name of the file system. The specifics of naming
filesystems is unspecified, but a name must be unique across the list of
exposed file systems.
- */
- name:string;
-
- /**
- * root The root directory of the file system.
- */
- root:DirectoryEntrySync;
-}
-
-/**
- * An abstract interface representing entries in a file system, each of which
may be a FileEntrySync or DirectoryEntrySync.
- */
-interface EntrySync{
- /**
- * EntrySync is a file.
- * @readonly
- */
- isFile:boolean;
-
- /**
- * EntrySync is a directory.
- * @readonly
- */
- isDirectory:boolean;
-
- /**
- * Look up metadata about this entry.
- */
- getMetadata():Metadata;
-
- /**
- * The name of the entry, excluding the path leading to it.
- */
- name:string;
-
- /**
- * The full absolute path from the root to the entry.
- */
- fullPath:string;
-
- /**
- * The file system on which the entry resides.
- */
- filesystem:FileSystemSync;
-
- /**
- * Move an entry to a different location on the file system. It is an
error to try to:
- * <ul>
- * <li> move a directory inside itself or to any child at any depth;</li>
- * <li> move an entry into its parent if a name different from its current
one isn't provided;</li>
- * <li> move a file to a path occupied by a directory;</li>
- * <li> move a directory to a path occupied by a file;</li>
- * <li> move any element to a path occupied by a directory which is not
empty.</li>
- * </ui>
- * A move of a file on top of an existing file must attempt to delete and
replace that file. A move of a directory on top of an existing empty directory
must attempt to delete and replace that directory.
- * @param parent The directory to which to move the entry.
- * @param newName The new name of the entry. Defaults to the EntrySync's
current name if unspecified.
- */
- moveTo(parent:DirectoryEntrySync, newName?:string):EntrySync;
-
- /**
- * Copy an entry to a different location on the file system. It is an
error to try to:
- * <ul>
- * <li> copy a directory inside itself or to any child at any depth;</li>
- * <li> copy an entry into its parent if a name different from its current
one isn't provided;</li>
- * <li> copy a file to a path occupied by a directory;</li>
- * <li> copy a directory to a path occupied by a file;</li>
- * <li> copy any element to a path occupied by a directory which is not
empty.</li>
- * </ui>
- * A copy of a file on top of an existing file must attempt to delete and
replace that file.
- * A copy of a directory on top of an existing empty directory must
attempt to delete and replace that directory.
- * Directory copies are always recursive--that is, they copy all contents
of the directory.
- */
- copyTo(parent:DirectoryEntrySync, newName?:string):EntrySync;
-
- /**
- * Returns a URL that can be used to identify this entry. Unlike the URN
defined in [FILE-API-ED], it has no specific expiration; as it describes a
location on disk, it should be valid at least as long as that location exists.
- */
- toURL():string;
-
- /**
- * Deletes a file or directory. It is an error to attempt to delete a
directory that is not empty. It is an error to attempt to delete the root
directory of a filesystem.
- */
- remove ():void;
-
- /**
- * Look up the parent DirectoryEntrySync containing this Entry. If this
EntrySync is the root of its filesystem, its parent is itself.
- */
- getParent():DirectoryEntrySync;
-}
-
-/**
- * This interface represents a directory on a file system.
- */
-interface DirectoryEntrySync extends EntrySync {
- /**
- * Creates a new DirectoryReaderSync to read EntrySyncs from this
DirectorySync.
- */
- createReader():DirectoryReaderSync;
-
- /**
- * Creates or looks up a directory.
- * @param path Either an absolute path or a relative path from this
DirectoryEntrySync to the file to be looked up or created. It is an error to
attempt to create a file whose immediate parent does not yet exist.
- * @param options
- * <ul>
- * <li> If create and exclusive are both true and the path already
exists, getFile must fail.</li>
- * <li> If create is true, the path doesn't exist, and no other error
occurs, getFile must create it as a zero-length file and return a corresponding
FileEntry.</li>
- * <li> If create is not true and the path doesn't exist, getFile must
fail.</li>
- * <li> If create is not true and the path exists, but is a directory,
getFile must fail.</li>
- * <li> Otherwise, if no other error occurs, getFile must return a
FileEntrySync corresponding to path.</li>
- * </ul>
- */
- getFile(path:string, options?:Flags):FileEntrySync;
-
- /**
- * Creates or looks up a directory.
- * @param path Either an absolute path or a relative path from this
DirectoryEntrySync to the directory to be looked up or created. It is an error
to attempt to create a directory whose immediate parent does not yet exist.
- * @param options
- * <ul>
- * <li> If create and exclusive are both true and the path already
exists, getDirectory must fail.</li>
- * <li> If create is true, the path doesn't exist, and no other error
occurs, getDirectory must create and return a corresponding DirectoryEntry.</li>
- * <li> If create is not true and the path doesn't exist, getDirectory
must fail.</li>
- * <li> If create is not true and the path exists, but is a file,
getDirectory must fail.</li>
- * <li> Otherwise, if no other error occurs, getDirectory must return
a DirectoryEntrySync corresponding to path.</li>
- * </ul>
- */
- getDirectory(path:string, options?:Flags):DirectoryEntrySync;
-
- /**
- * Deletes a directory and all of its contents, if any. In the event of an
error [e.g. trying to delete a directory that contains a file that cannot be
removed], some of the contents of the directory may be deleted. It is an error
to attempt to delete the root directory of a filesystem.
- */
- removeRecursively():void;
-}
-
-/**
- * This interface lets a user list files and directories in a directory. If
there are no additions to or deletions from a directory between the first and
last call to readEntries, and no errors occur, then:
- * <ul>
- * <li> A series of calls to readEntries must return each entry in the
directory exactly once.</li>
- * <li> Once all entries have been returned, the next call to readEntries must
produce an empty array.</li>
- * <li> If not all entries have been returned, the array produced by
readEntries must not be empty.</li>
- * <li> The entries produced by readEntries must not include the directory
itself ["."] or its parent [".."].</li>
- * </ul>
- */
-interface DirectoryReaderSync {
- /**
- * Read the next block of entries from this directory.
- */
- readEntries():EntrySync[];
-}
-
-/**
- * This interface represents a file on a file system.
- */
-interface FileEntrySync extends EntrySync {
- /**
- * Creates a new FileWriterSync associated with the file that this
FileEntrySync represents.
- */
- createWriter():FileWriterSync;
-
- /**
- * Returns a File that represents the current state of the file that this
FileEntrySync represents.
- */
- file():File;
-}
-
-interface Window extends LocalFileSystem, LocalFileSystemSync{
-}
-
-interface WorkerGlobalScope extends LocalFileSystem, LocalFileSystemSync{
-}
diff --git a/decl/filewriter/filewriter.d.ts b/decl/filewriter/filewriter.d.ts
deleted file mode 100644
index 78370f1d..00000000
--- a/decl/filewriter/filewriter.d.ts
+++ /dev/null
@@ -1,176 +0,0 @@
-// Type definitions for File API: Writer
-// Project: http://www.w3.org/TR/file-writer-api/
-// Definitions by: Kon <http://phyzkit.net/>
-// Definitions: https://github.com/borisyankov/DefinitelyTyped
-
-/**
- * This interface provides methods to monitor the asynchronous writing of
blobs to disk using progress events [PROGRESS-EVENTS] and event handler
attributes.
- * This interface is specified to be used within the context of the global
object (Window [HTML5]) and within Web Workers (WorkerUtils [WEBWORKERS-ED]).
- */
-interface FileSaver extends EventTarget {
- /**
- * When the abort method is called, user agents must run the steps below:
- * <ol>
- * <li> If readyState == DONE or readyState == INIT, terminate this
overall series of steps without doing anything else. </li>
- * <li> Set readyState to DONE. </li>
- * <li> If there are any tasks from the object's FileSaver task source in
one of the task queues, then remove those tasks. </li>
- * <li> Terminate the write algorithm being processed. </li>
- * <li> Set the error attribute to a DOMError object of type "AbortError".
</li>
- * <li> Fire a progress event called abort </li>
- * <li> Fire a progress event called writeend </li>
- * <li> Terminate this algorithm. </li>
- * </ol>
- */
- abort():void;
-
- /**
- * The blob is being written.
- * @readonly
- */
- INIT:number;
-
- /**
- * The object has been constructed, but there is no pending write.
- * @readonly
- */
- WRITING:number;
-
- /**
- * The entire Blob has been written to the file, an error occurred during
the write, or the write was aborted using abort(). The FileSaver is no longer
writing the blob.
- * @readonly
- */
- DONE:number;
-
- /**
- * The FileSaver object can be in one of 3 states. The readyState
attribute, on getting, must return the current state, which must be one of the
following values:
- * <ul>
- * <li>INIT</li>
- * <li>WRITING</li>
- * <li>DONE</li>
- * <ul>
- * @readonly
- */
- readyState:number;
-
- /**
- * The last error that occurred on the FileSaver.
- * @readonly
- */
- error:DOMError;
-
- /**
- * Handler for writestart events
- */
- onwritestart:Function;
-
- /**
- * Handler for progress events.
- */
- onprogress:Function;
-
- /**
- * Handler for write events.
- */
- onwrite:Function;
-
- /**
- * Handler for abort events.
- */
- onabort:Function;
-
- /**
- * Handler for error events.
- */
- onerror:Function;
-
- /**
- * Handler for writeend events.
- */
- onwriteend:Function;
-}
-
-declare var FileSaver: {
- /**
- * When the FileSaver constructor is called, the user agent must return a
new FileSaver object with readyState set to INIT.
- * This constructor must be visible when the script's global object is
either a Window object or an object implementing the WorkerUtils interface.
- */
- new(data:Blob): FileSaver;
-};
-
-/**
- * This interface expands on the FileSaver interface to allow for multiple
write actions, rather than just saving a single Blob.
- */
-interface FileWriter extends FileSaver {
- /**
- * The byte offset at which the next write to the file will occur. This
must be no greater than length.
- * A newly-created FileWriter must have position set to 0.
- */
- position:number;
-
- /**
- * The length of the file. If the user does not have read access to the
file, this must be the highest byte offset at which the user has written.
- */
- length:number;
-
- /**
- * Write the supplied data to the file at position.
- * @param data The blob to write.
- */
- write(data:Blob):void;
-
- /**
- * Seek sets the file position at which the next write will occur.
- * @param offset If nonnegative, an absolute byte offset into the file. If
negative, an offset back from the end of the file.
- */
- seek(offset:number):void;
-
- /**
- * Changes the length of the file to that specified. If shortening the
file, data beyond the new length must be discarded. If extending the file, the
existing data must be zero-padded up to the new length.
- * @param size The size to which the length of the file is to be adjusted,
measured in bytes.
- */
- truncate(size:number):void;
-}
-
-/**
- * This interface lets users write, truncate, and append to files using simple
synchronous calls.
- * This interface is specified to be used only within Web Workers (WorkerUtils
[WEBWORKERS]).
- */
-interface FileWriterSync {
- /**
- * The byte offset at which the next write to the file will occur. This
must be no greater than length.
- */
- position:number;
-
- /**
- * The length of the file. If the user does not have read access to the
file, this must be the highest byte offset at which the user has written.
- */
- length:number;
-
- /**
- * Write the supplied data to the file at position. Upon completion,
position will increase by data.size.
- * @param data The blob to write.
- */
- write(data:Blob):void;
-
- /**
- * Seek sets the file position at which the next write will occur.
- * @param offset An absolute byte offset into the file. If offset is
greater than length, length is used instead. If offset is less than zero,
length is added to it, so that it is treated as an offset back from the end of
the file. If it is still less than zero, zero is used.
- */
- seek(offset:number):void;
-
- /**
- * Changes the length of the file to that specified. If shortening the
file, data beyond the new length must be discarded. If extending the file, the
existing data must be zero-padded up to the new length.
- * Upon successful completion:
- * <ul>
- * <li>length must be equal to size.</li>
- * <li>position must be the lesser of
- * <ul>
- * <li>its pre-truncate value,</li>
- * <li>size.</li>
- * </ul>
- * </li>
- * </ul>
- * @param size The size to which the length of the file is to be adjusted,
measured in bytes.
- */
- truncate(size:number):void;
-}
diff --git a/decl/jed.d.ts b/decl/jed.d.ts
deleted file mode 100644
index b156702e..00000000
--- a/decl/jed.d.ts
+++ /dev/null
@@ -1,18 +0,0 @@
-
-interface JedInstance {
- translate: any;
- ngettext: any;
-}
-
-interface JedConstructor {
- new(s: any): JedInstance;
-}
-
-declare namespace JedLib {
- const Jed: JedConstructor;
-}
-
-declare module "jed" {
- export = JedLib;
-}
-
diff --git a/decl/urijs.d.ts b/decl/urijs.d.ts
deleted file mode 100644
index 8307f8e9..00000000
--- a/decl/urijs.d.ts
+++ /dev/null
@@ -1,227 +0,0 @@
-// Type definitions for URI.js 1.15.1
-// Project: https://github.com/medialize/URI.js
-// Definitions by: RodneyJT <https://github.com/RodneyJT>, Brian Surowiec
<https://github.com/xt0rted>
-// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
-// Modified by Florian Dold <address@hidden>
-
-declare module "urijs" {
- interface URIOptions {
- protocol?: string;
- username?: string;
- password?: string;
- hostname?: string;
- port?: string;
- path?: string;
- query?: string;
- fragment?: string;
- }
-
- class URI {
- public constructor();
- public constructor (value: string | URIOptions | HTMLElement);
-
- static addQuery(data: Object, prop: string, value: string): Object;
- static addQuery(data: Object, qryObj: Object): Object;
-
- static build(parts: {
- protocol: string;
- username: string;
- password: string;
- hostname: string;
- port: string;
- path: string;
- query: string;
- fragment: string;
- }): string;
- static buildAuthority(parts: {
- username?: string;
- password?: string;
- hostname?: string;
- port?: string;
- }): string;
- static buildHost(parts: {
- hostname?: string;
- port?: string;
- }): string;
- static buildQuery(qry: Object): string;
- static buildQuery(qry: Object, duplicates: boolean): string;
- static buildUserinfo(parts: {
- username?: string;
- password?: string;
- }): string;
-
- static commonPath(path1: string, path2: string): string;
-
- static decode(str: string): string;
- static decodeQuery(qry: string): string;
-
- static encode(str: string): string;
- static encodeQuery(qry: string): string;
- static encodeReserved(str: string): string;
- static expand(template: string, vals: Object): URI;
-
- static iso8859(): void;
-
- static joinPaths(...paths: (string | URI)[]): URI;
-
- static parse(url: string): {
- protocol: string;
- username: string;
- password: string;
- hostname: string;
- port: string;
- path: string;
- query: string;
- fragment: string;
- };
- static parseAuthority(url: string, parts: {
- username?: string;
- password?: string;
- hostname?: string;
- port?: string;
- }): string;
- static parseHost(url: string, parts: {
- hostname?: string;
- port?: string;
- }): string;
- static parseQuery(url: string): Object;
- static parseUserinfo(url: string, parts: {
- username?: string;
- password?: string;
- }): string;
-
- static removeQuery(data: Object, prop: string, value: string): Object;
- static removeQuery(data: Object, props: string[]): Object;
- static removeQuery(data: Object, props: Object): Object;
-
- static unicode(): void;
-
- static withinString(source: string, func: (url: string) => string): string;
-
- absoluteTo(path: string): URI;
- absoluteTo(path: URI): URI;
- addFragment(fragment: string): URI;
- addQuery(qry: string): URI;
- addQuery(qry: Object): URI;
- addSearch(qry: string): URI;
- addSearch(key: string, value:any): URI;
- addSearch(qry: Object): URI;
- authority(): string;
- authority(authority: string): URI;
-
- clone(): URI;
-
- directory(): string;
- directory(dir: boolean): string;
- directory(dir: string): URI;
- domain(): string;
- domain(domain: boolean): string;
- domain(domain: string): URI;
-
- duplicateQueryParameters(val: boolean): URI;
-
- equals(): boolean;
- equals(url: string | URI): boolean;
-
- filename(): string;
- filename(file: boolean): string;
- filename(file: string): URI;
- fragment(): string;
- fragment(fragment: string): URI;
- fragmentPrefix(prefix: string): URI;
-
- hash(): string;
- hash(hash: string): URI;
- host(): string;
- host(host: string): URI;
- hostname(): string;
- hostname(hostname: string): URI;
- href(): string;
- href(url: string): void;
-
- is(qry: string): boolean;
- iso8859(): URI;
-
- normalize(): URI;
- normalizeFragment(): URI;
- normalizeHash(): URI;
- normalizeHostname(): URI;
- normalizePath(): URI;
- normalizePathname(): URI;
- normalizePort(): URI;
- normalizeProtocol(): URI;
- normalizeQuery(): URI;
- normalizeSearch(): URI;
-
- origin(): string;
- origin(uri: string | URI): URI;
-
- password(): string;
- password(pw: string): URI;
- path(): string;
- path(path: boolean): string;
- path(path: string): URI;
- pathname(): string;
- pathname(path: boolean): string;
- pathname(path: string): URI;
- port(): string;
- port(port: string): URI;
- protocol(): string;
- protocol(protocol: string): URI;
-
- query(): string;
- query(qry: string): URI;
- query(qry: boolean): Object;
- query(qry: Object): URI;
-
- readable(): string;
- relativeTo(path: string): URI;
- removeQuery(qry: string): URI;
- removeQuery(qry: Object): URI;
- removeSearch(qry: string): URI;
- removeSearch(qry: Object): URI;
- resource(): string;
- resource(resource: string): URI;
-
- scheme(): string;
- scheme(protocol: string): URI;
- search(): string;
- search(qry: string): URI;
- search(qry: boolean): any;
- search(qry: Object): URI;
- segment(): string[];
- segment(segments: string[]): URI;
- segment(position: number): string;
- segment(position: number, level: string): URI;
- segment(segment: string): URI;
- segmentCoded(): string[];
- segmentCoded(segments: string[]): URI;
- segmentCoded(position: number): string;
- segmentCoded(position: number, level: string): URI;
- segmentCoded(segment: string): URI;
- setQuery(key: string, value: string): URI;
- setQuery(qry: Object): URI;
- setSearch(key: string, value: string): URI;
- setSearch(qry: Object): URI;
- hasQuery(name: string | any, value?: string | number | boolean | Function
| Array<string> | Array<number> | Array<boolean> | RegExp, withinArray?:
boolean): boolean;
- hasSearch(name: string | any, value?: string | number | boolean | Function
| Array<string> | Array<number> | Array<boolean> | RegExp, withinArray?:
boolean): boolean;
- subdomain(): string;
- subdomain(subdomain: string): URI;
- suffix(): string;
- suffix(suffix: boolean): string;
- suffix(suffix: string): URI;
-
- tld(): string;
- tld(tld: boolean): string;
- tld(tld: string): URI;
-
- unicode(): URI;
- userinfo(): string;
- userinfo(userinfo: string): URI;
- username(): string;
- username(uname: string): URI;
-
- valueOf(): string;
- }
- export = URI;
-}
diff --git a/gulpfile.js b/gulpfile.js
index 0a2b2c26..1ebeb256 100644
--- a/gulpfile.js
+++ b/gulpfile.js
@@ -52,11 +52,6 @@ const paths = {
"src/**/*.{ts,tsx,js}",
"!src/**/*-test*.ts",
],
- decl: [
- "decl/jed.d.ts",
- "decl/chrome/chrome.d.ts",
- "decl/urijs.d.ts",
- ],
test: [
"src/**/*-test*.ts",
],
@@ -78,7 +73,6 @@ const paths = {
"Makefile",
"README",
"configure",
- "decl/**/*.d.ts",
"gulpfile.js",
"manifest.json",
"package.json",
@@ -223,7 +217,6 @@ function srcdist() {
// We can't just concat patterns due to exclude patterns
const files = concatStreams(
gulp.src(paths.ts.src, opts),
- gulp.src(paths.ts.decl, opts),
gulp.src(paths.ts.test, opts),
gulp.src(paths.dist, opts),
gulp.src(paths.extra, opts));
@@ -341,8 +334,7 @@ function tsconfig() {
let opts = {base: "."};
const files = concatStreams(
vfs.src(paths.ts.src, opts),
- vfs.src(paths.ts.test, opts),
- vfs.src(paths.ts.decl, opts));
+ vfs.src(paths.ts.test, opts));
return files.pipe(genTSConfig(tsBaseArgs))
.pipe(gulp.dest("."));
}
diff --git a/package.json b/package.json
index 6c844817..e080cae4 100644
--- a/package.json
+++ b/package.json
@@ -46,9 +46,11 @@
"webpack-merge": "^4.1.0"
},
"dependencies": {
+ "@types/chrome": "^0.0.88",
+ "@types/urijs": "^1.19.3",
"axios": "^0.19.0",
"commander": "^2.20.0",
- "idb-bridge": "0.0.2",
+ "idb-bridge": "0.0.3",
"source-map-support": "^0.5.12",
"urijs": "^1.18.10"
}
diff --git a/src/i18n.tsx b/src/i18n.tsx
index ddf4fb76..29df1c5a 100644
--- a/src/i18n.tsx
+++ b/src/i18n.tsx
@@ -23,7 +23,9 @@
*/
import {strings} from "./i18n/strings";
+// @ts-ignore: no type decl for this library
import * as jedLib from "jed";
+
import * as React from "react";
--
To stop receiving notification emails like this one, please contact
address@hidden.
- [GNUnet-SVN] [taler-wallet-webex] branch master updated (67dc8d30 -> 43cccf2c), gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 02/10: move selenium to contrib, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 03/10: only invoke afterCommitCallback for transactions that change data, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 04/10: bump idb-bridge version, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 10/10: idb-bridge: version bump, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 08/10: idb-bridge: fix bug in index deletion, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 05/10: do not ignore database version, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 06/10: version bump / imports, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 09/10: start with an actual wallet cli, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 07/10: idb-bridge: indexes belong to object stores, gnunet, 2019/08/16
- [GNUnet-SVN] [taler-wallet-webex] 01/10: use packaged type declarations,
gnunet <=