Index: chrome/common/extensions/api/events.json |
diff --git a/chrome/common/extensions/api/declarative.json b/chrome/common/extensions/api/events.json |
similarity index 56% |
rename from chrome/common/extensions/api/declarative.json |
rename to chrome/common/extensions/api/events.json |
index bf5ab508e38e462569f305d5e1dfa351662f76c4..9eac5a23077266be19e52c657d7f94ea2a00a03a 100644 |
--- a/chrome/common/extensions/api/declarative.json |
+++ b/chrome/common/extensions/api/events.json |
@@ -4,11 +4,117 @@ |
[ |
{ |
- "namespace": "declarative", |
+ "namespace": "events", |
"internal": true, |
- "documentation_permissions_required": ["declarative"], |
+ "unprivileged": true, |
"types": [ |
{ |
+ "id": "Event", |
+ "type": "object", |
+ "description": "An object which allows the addition and removal of listeners for a Chrome event.", |
+ "additionalProperties": { "type": "any"}, |
+ "functions": [ |
+ // TODO(battre): Add correct signatures. |
+ { "name": "addListener", "type": "function", "parameters": [] }, |
+ { "name": "removeListener", "type": "function", "parameters": [] }, |
+ { "name": "hasListener", "type": "function", "parameters": [] }, |
+ { "name": "hasListeners", "type": "function", "parameters": [] }, |
+ { |
+ "name": "addRules", |
+ "type": "function", |
+ "description": "Registers rules to handle events. Note that you cannot call this function as <code>chrome.declarative.addRules(...)</code>. Instead a function of this signature is provided for event objects supporting the declarative API such as <code>chrome.declarativeWebRequest.onRequest</code>.", |
+ "parameters": [ |
+ { |
+ "nodoc": "true", |
+ "name": "eventName", |
+ "type": "string", |
+ "description": "Name of the event this function affects." |
+ }, |
+ { |
+ "name": "rules", |
+ "type": "array", |
+ "items": {"$ref": "Rule"}, |
+ "description": "Rules to be registered. These do not replace previously registered rules." |
+ }, |
+ { |
+ "name": "callback", |
+ "optional": true, |
+ "type": "function", |
+ "parameters": [ |
+ { |
+ "name": "rules", |
+ "type": "array", |
+ "items": {"$ref": "Rule"}, |
+ "description": "Rules that were registered, the optional parameters are filled with values." |
+ } |
+ ], |
+ "description": "Called with registered rules." |
+ } |
+ ] |
+ }, |
+ { |
+ "name": "getRules", |
+ "type": "function", |
+ "description": "Returns currently registered rules. Note that you cannot call this function as <code>chrome.declarative.getRules(...)</code>. Instead a function of this signature is provided for event objects supporting the declarative API such as <code>chrome.declarativeWebRequest.onRequest</code>.", |
+ "parameters": [ |
+ { |
+ "nodoc": "true", |
+ "name": "eventName", |
+ "type": "string", |
+ "description": "Name of the event this function affects." |
+ }, |
+ { |
+ "name": "ruleIdentifiers", |
+ "optional": "true", |
+ "type": "array", |
+ "items": {"type": "string"}, |
+ "description": "If an array is passed, only rules with identifiers contained in this array are returned." |
+ }, |
+ { |
+ "name": "callback", |
+ "type": "function", |
+ "parameters": [ |
+ { |
+ "name": "rules", |
+ "type": "array", |
+ "items": {"$ref": "Rule"}, |
+ "description": "Rules that were registered, the optional parameters are filled with values." |
+ } |
+ ], |
+ "description": "Called with registered rules." |
+ } |
+ ] |
+ }, |
+ { |
+ "name": "removeRules", |
+ "type": "function", |
+ "description": "Unregisters currently registered rules. Note that you cannot call this function as <code>chrome.declarative.removeRules(...)</code>. Instead a function of this signature is provided for event objects supporting the declarative API such as <code>chrome.declarativeWebRequest.onRequest</code>.", |
+ "parameters": [ |
+ { |
+ "nodoc": "true", |
+ "name": "eventName", |
+ "type": "string", |
+ "description": "Name of the event this function affects." |
+ }, |
+ { |
+ "name": "ruleIdentifiers", |
+ "optional": "true", |
+ "type": "array", |
+ "items": {"type": "string"}, |
+ "description": "If an array is passed, only rules with identifiers contained in this array are unregistered." |
+ }, |
+ { |
+ "name": "callback", |
+ "optional": true, |
+ "type": "function", |
+ "parameters": [], |
+ "description": "Called when rules were unregistered." |
+ } |
+ ] |
+ } |
+ ] |
+ }, |
+ { |
"id": "Rule", |
"type": "object", |
"description": "Description of a declarative rule for handling events.", |
@@ -135,101 +241,6 @@ |
} |
} |
} |
- ], |
- "functions": [ |
- { |
- "name": "addRules", |
- "type": "function", |
- "description": "Registers rules to handle events. Note that you cannot call this function as <code>chrome.declarative.addRules(...)</code>. Instead a function of this signature is provided for event objects supporting the declarative API such as <code>chrome.declarativeWebRequest.onRequest</code>.", |
- "parameters": [ |
- { |
- "nodoc": "true", |
- "name": "eventName", |
- "type": "string", |
- "description": "Name of the event this function affects." |
- }, |
- { |
- "name": "rules", |
- "type": "array", |
- "items": {"$ref": "Rule"}, |
- "description": "Rules to be registered. These do not replace previously registered rules." |
- }, |
- { |
- "name": "callback", |
- "optional": true, |
- "type": "function", |
- "parameters": [ |
- { |
- "name": "rules", |
- "type": "array", |
- "items": {"$ref": "Rule"}, |
- "description": "Rules that were registered, the optional parameters are filled with values." |
- } |
- ], |
- "description": "Called with registered rules." |
- } |
- ] |
- }, |
- { |
- "name": "getRules", |
- "type": "function", |
- "description": "Returns currently registered rules. Note that you cannot call this function as <code>chrome.declarative.getRules(...)</code>. Instead a function of this signature is provided for event objects supporting the declarative API such as <code>chrome.declarativeWebRequest.onRequest</code>.", |
- "parameters": [ |
- { |
- "nodoc": "true", |
- "name": "eventName", |
- "type": "string", |
- "description": "Name of the event this function affects." |
- }, |
- { |
- "name": "ruleIdentifiers", |
- "optional": "true", |
- "type": "array", |
- "items": {"type": "string"}, |
- "description": "If an array is passed, only rules with identifiers contained in this array are returned." |
- }, |
- { |
- "name": "callback", |
- "type": "function", |
- "parameters": [ |
- { |
- "name": "rules", |
- "type": "array", |
- "items": {"$ref": "Rule"}, |
- "description": "Rules that were registered, the optional parameters are filled with values." |
- } |
- ], |
- "description": "Called with registered rules." |
- } |
- ] |
- }, |
- { |
- "name": "removeRules", |
- "type": "function", |
- "description": "Unregisters currently registered rules. Note that you cannot call this function as <code>chrome.declarative.removeRules(...)</code>. Instead a function of this signature is provided for event objects supporting the declarative API such as <code>chrome.declarativeWebRequest.onRequest</code>.", |
- "parameters": [ |
- { |
- "nodoc": "true", |
- "name": "eventName", |
- "type": "string", |
- "description": "Name of the event this function affects." |
- }, |
- { |
- "name": "ruleIdentifiers", |
- "optional": "true", |
- "type": "array", |
- "items": {"type": "string"}, |
- "description": "If an array is passed, only rules with identifiers contained in this array are unregistered." |
- }, |
- { |
- "name": "callback", |
- "optional": true, |
- "type": "function", |
- "parameters": [], |
- "description": "Called when rules were unregistered." |
- } |
- ] |
- } |
] |
} |
] |