1
|
<!DOCTYPE html><!-- This page is a placeholder for generated extensions api doc. Note: 1) The <head> information in this page is significant, should be uniform across api docs and should be edited only with knowledge of the templating mechanism. 2) The <body> tag *must* retain id="body" 3) All <body>.innerHTML is genereated as an rendering step. If viewed in a browser, it will be re-generated from the template, json schema and authored overview content. 4) The <body>.innerHTML is also generated by an offline step so that this page may easily be indexed by search engines. TODO(rafaelw): Abstract this into a "pageshell" that becomes the single version of page template shell and the "instance" pages (bookmarks.html, etc...) can be generated with a build step. --><!-- <html> must retain id="template --><html xmlns="http://www.w3.org/1999/xhtml" jstcache="0"><!-- <head> data is significant and loads the needed libraries and styles --><head jstcache="0"> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" jstcache="0"> <title jscontent="pageTitle" jstcache="1">index</title> <link href="css/ApiRefStyles.css" rel="stylesheet" type="text/css" jstcache="0"> <script type="text/javascript" src="../../../third_party/jstemplate/jstemplate_compiled.js" jstcache="0"> </script> <script type="text/javascript" src="js/api_page_generator.js" jstcache="0"></script> <script type="text/javascript" src="js/bootstrap.js" jstcache="0"></script> </head><!-- <body> content is completely generated. Do not edit, as it will be and rewritten. --><body class="" jstcache="0"> <div id="container" jstcache="0"> <a name="top" jstcache="0"> </a> <!-- API HEADER --> <div id="pageHeader" jstcache="0"> <!-- BREADCRUMB --> <!-- TODO: Fix these hrefs --> <div id="breadcrumbs" jstcache="0"> <a href="index.html" jstcache="0">Google Chrome Extensions</a> > <a href="reference_index.html" jstcache="0">Reference</a> > <a href="api_index.html" jstcache="0">chrome.* APIs</a> > <span jscontent="namespace" jstcache="2">null</span> </div> <div id="searchbox" jstcache="0"> <form action="http://www.google.com/cse" id="cse-search-box" jstcache="0"> <div jstcache="0"> <input type="hidden" name="cx" value="002967670403910741006:61_cvzfqtno" jstcache="0"> <input type="hidden" name="ie" value="UTF-8" jstcache="0"> <input type="text" name="q" size="31" jstcache="0"> <input type="submit" name="sa" value="Search" jstcache="0"> </div> </form> <script type="text/javascript" src="http://www.google.com/jsapi" jstcache="0"></script> <script type="text/javascript" jstcache="0">google.load("elements", "1", {packages: "transliteration"});</script> <script type="text/javascript" src="http://www.google.com/coop/cse/t13n?form=cse-search-box&t13n_langs=en" jstcache="0"></script> <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse-search-box&lang=en" jstcache="0"></script> </div> <div id="pageTitle" jstcache="0"> <h1 jscontent="h1Header" jstcache="3">index</h1> </div> </div> <!-- /pageHeader --> <div id="pageContent" jstcache="0"> <!-- SIDENAV --> <div id="leftNav" jstcache="0"> <ul jstcache="0"> <li jstcache="0"> <a href="overview.html" jstcache="0">Overview</a></li> <li jstcache="0"> <a href="getstarted.html" jstcache="0">Get Started</a></li> <li jstcache="0"> <a href="devguide.html" jstcache="0">Developer's Guide</a></li> <li jstcache="0"> Reference <ul jstcache="0"> <li jstcache="0"> <a href="api_index.html" jstcache="0">Extension APIs</a> <ul jstcache="0"> <li jsselect="apiModules" jstcache="18" jsinstance="0"> <a jscontent="name" jsvalues=".href:module + '.html'" jstcache="25" href="bookmarks.html">Bookmarks</a> </li><li jsselect="apiModules" jstcache="18" jsinstance="1"> <a jscontent="name" jsvalues=".href:module + '.html'" jstcache="25" href="pageActions.html">PageActions</a> </li><li jsselect="apiModules" jstcache="18" jsinstance="2"> <a jscontent="name" jsvalues=".href:module + '.html'" jstcache="25" href="windows.html">Windows</a> </li><li jsselect="apiModules" jstcache="18" jsinstance="3"> <a jscontent="name" jsvalues=".href:module + '.html'" jstcache="25" href="tabs.html">Tabs</a> </li><li jsselect="apiModules" jstcache="18" jsinstance="*4"> <a jscontent="name" jsvalues=".href:module + '.html'" jstcache="25" href="self.html">Self</a> </li> </ul> </li> </ul> </li> </ul> </div> <div id="mainColumn" jstcache="0"> <!-- TABLE OF CONTENTS --> <div id="toc" jsselect="apiDefinition" jstcache="4" style="display: none; "> <p jstcache="0">Contents</p> <ol jstcache="0"> <li jstcache="0"> <a href="#overview" jstcache="0">Description</a> <ol jstcache="0"> <li jstcache="0"><a href="#overview-properties" jstcache="0">Properties</a></li> <li jstcache="0"><a href="#overview-examples" jstcache="0">Examples</a></li> </ol> </li> <li jstcache="0"> <a href="#methods" jstcache="0">Methods</a> <ol jstcache="0"> <li jsselect="functions" jstcache="5"> <a jscontent="name" jsvalues=".href:'#method-' + name" href="#method-anchor" jstcache="19">methodName</a> </li> </ol> </li> <li jstcache="0"> <a href="#events" jstcache="0">Events</a> <ol jstcache="0"> <li jsselect="events" jstcache="6"> <a jscontent="name" jsvalues=".href:'#event-' + name" href="#event-anchor" jstcache="20">eventName</a> </li> </ol> </li> <!-- TODO: What do we do about structs/types? --> <li jstcache="0"> <a href="#structs" jstcache="0">TODO: Structs</a> <ol jstcache="0"> <li jstcache="0"><a href="#struct-BookmarkTreeNode" jstcache="0"></a></li> </ol> </li> </ol> [PENDING: links to all h2s and h3s should go here -- would it be possible to link to overview h3s, as well? if so, how should we create their anchor/id values?] </div> <!-- /TABLE OF CONTENTS --> <!-- STATIC CONTENT PLACEHOLDER --> <div id="static" jstcache="0"><p jstcache="0"> If you want to customize Google Chrome, you've come to the right place. An <em jstcache="0">extension</em> is a bundle of web code (HTML, JavaScript, perhaps some CSS) that lets you add functionality or a bit of user interface (usually both) to the browser. <a href="http://dev.chromium.org/developers/design-documents/extensions/samples" jstcache="0">Examples of extensions</a> include a mail checker, a newsfeed subscriber, and a status monitor.<br jstcache="0"> </p> <h3 jstcache="0">Contents</h3> <p jstcache="0"> This documentation is just being written; here's what we have so far. You might also want to look at <a href="#other" jstcache="0">Other resources</a>. If you just want to <em jstcache="0">make</em> something, go to <a href="helloworld.html" jstcache="0">Get Started</a>. </p> <ul jstcache="0"> <li jstcache="0"><a href="overview.html" jstcache="0">Overview</a></li> <li jstcache="0"><a href="helloworld.html" jstcache="0">Get Started</a> (Hello, World!)</li> <li jstcache="0"><a href="devguide.html" jstcache="0">Developer's Guide</a></li> <li jstcache="0"><a href="reference/index.html" jstcache="0">Reference</a></li> <ul jstcache="0"> <li jstcache="0">Supported APIs</li> <ul jstcache="0"> <li jstcache="0">standard JavaScript libraries</li> <li jstcache="0">XMLHttpRequest</li> <li jstcache="0">anything in WebKit</li> <li jstcache="0">anything in V8</li> <li jstcache="0">anything you put in your zipfile</li> </ul> <li jstcache="0"><a href="reference/chrome-api-index.html" jstcache="0">chrome.* APIs</a> <ul jstcache="0"> <li jstcache="0">[PENDING: fill this out automatically. In the meantime, start at the <a href="reference/bookmarks.html" jstcache="0">chrome.bookmarks</a> page and click the links in the left column.]</li> </ul> </li> </ul> <li jstcache="0">Samples</li> <ul jstcache="0"> <li jstcache="0">#1</li> <li jstcache="0">#2</li> </ul> </ul> <h3 id="other" jstcache="0">Other resources</h3> <ul jstcache="0"> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions" jstcache="0">Design documents</a>:</li> <ul jstcache="0"> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/howto" jstcache="0">HOWTO</a>: The precursor to Get Started [PENDING: make sure it's still useful]</li> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/packaging" jstcache="0">Packaging</a>: [PENDING: might be obsolete]</li> <li jstcache="0">APIs:</li> <ul jstcache="0"> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/bookmarks-api" jstcache="0">Bookmarks</a></li> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/events" jstcache="0">Events</a></li> </ul> <ul jstcache="0"> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/tabs-api" jstcache="0">Tabs</a></li> </ul> <ul jstcache="0"> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/windows-api" jstcache="0">Windows</a></li> </ul> <li jstcache="0">Features:</li> <ul jstcache="0"> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/toolstrips" jstcache="0">Toolstrips</a>: Add UI to the toolbar area</li> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/content-scripts" jstcache="0">Content scripts</a>: Run code within the context of web pages</li> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/background-pages" jstcache="0">Background pages</a>: Run code that's not directly related to the UI</li> <li jstcache="0"><a href="http://dev.chromium.org/developers/design-documents/extensions/cross-origin-xhr" jstcache="0">Cross-Origin XMLHttpRequest</a>: Communicate with multiple domains</li> </ul> </ul> <li jstcache="0"><a href="http://groups.google.com/group/chromium-extensions" jstcache="0">chromium-extensions</a> (discussion group)</li> </ul> </div> <!-- API PAGE --> <div class="apiPage" jsselect="apiDefinition" jstcache="4" style="display: none; "> <!-- METHODS --> <div class="apiGroup" id="methods" jstcache="0"> <a name="#methods" jstcache="0"></a> <h2 jstcache="0">Methods</h2> <!-- iterates over all functions --> <div class="apiItem" jsselect="functions" jstcache="5"> <a jsvalues=".name:'method-' + name" jstcache="7"></a> <!-- method-anchor --> <h3 jscontent="name" jstcache="8">method name</h3> <div class="summary" jstcache="0"><span jsdisplay="returns" jscontent="returns.typeName" jstcache="10">void</span> <!-- Note: intentionally longer 80 columns --> <span jscontent="fullName" jstcache="11">chrome.module.methodName</span>(<span jsselect="parameters" jsvalues="class:optional ? 'optional' : ''" jstcache="12"><span jsdisplay="$index" jstcache="21">, </span><span jscontent="typeName" jstcache="22"></span> <var jstcache="0"><span jscontent="name" jstcache="8"></span></var></span>)</div> <div class="description" jstcache="0"> <p class="todo" jsdisplay="!description" jstcache="13">Undocumented.</p> <p jsdisplay="description" jsvalues=".innerHTML:description" jstcache="14"> A description from the json schema def of the function goes here. </p> <!-- PARAMETERS --> <h4 jstcache="0">Parameters</h4> <dl jstcache="0"> <div jsselect="parameters" jstcache="23"> <dt jstcache="0"> <!-- Note: intentionally longer 80 columns --> <var jscontent="name" jstcache="8">paramName</var><em jstcache="0"> (<span class="optional" jsdisplay="optional" jstcache="31">optional </span><span jscontent="typeName" jstcache="22">paramType</span>)</em> </dt> <dd class="todo" jsdisplay="!$this.description" jstcache="26"> Undocumented. </dd> <dd jsdisplay="$this.description" jsvalues=".innerHTML:$this.description" jstcache="27"> Description of this parameter from the json schema. </dd> <!-- OBJECT PROPERTIES --> <dd jsdisplay="_propertyList" jstcache="28"> <dl jstcache="0"> <div jsselect="_propertyList" jstcache="32"> <dt jstcache="0"> <!-- Note: intentionally longer 80 columns --> <var jscontent="name" jstcache="8">paramName</var><em jstcache="0"> (<span class="optional" jsdisplay="optional" jstcache="31">optional </span><span jscontent="typeName" jstcache="22">paramType</span>)</em> </dt> <dd class="todo" jsdisplay="!$this.description" jstcache="26"> Undocumented. </dd> <dd jsdisplay="$this.description" jsvalues=".innerHTML:$this.description" jstcache="27"> Description of this parameter from the json schema. </dd> </div> </dl> </dd> </div> </dl> <!-- RETURNS --> <h4 jsdisplay="returns" jstcache="15">Returns</h4> <dl jstcache="0"> <div jsselect="returns" jstcache="24"> <dt jstcache="0"> <!-- Note: intentionally longer 80 columns --> <var jscontent="name" jstcache="8">paramName</var> <em jstcache="0">(<span jscontent="typeName" jstcache="22">paramType</span>)</em> </dt> <dd class="todo" jsdisplay="!$this.description" jstcache="26"> Undocumented. </dd> <dd jsdisplay="$this.description" jsvalues=".innerHTML:$this.description" jstcache="27"> Description of this parameter from the json schema. </dd> <!-- OBJECT PROPERTIES --> <dd jsdisplay="_propertyList" jstcache="28"> <dl jstcache="0"> <div jsselect="_propertyList" jstcache="32"> <dt jstcache="0"> <!-- Note: intentionally longer 80 columns --> <var jscontent="name" jstcache="8">paramName</var><em jstcache="0"> (<span class="optional" jsdisplay="optional" jstcache="31">optional </span><span jscontent="typeName" jstcache="22">paramType</span>)</em> </dt> <dd class="todo" jsdisplay="!$this.description" jstcache="26"> Undocumented. </dd> <dd jsdisplay="$this.description" jsvalues=".innerHTML:$this.description" jstcache="27"> Description of this parameter from the json schema. </dd> </div> </dl> </dd> </div> </dl> <!-- CALLBACK --> <div jsdisplay="callbackParameters" jstcache="16"> <h4 jstcache="0">Callback function</h4> <p jstcache="0"> If you specify the <em jstcache="0">callback</em> parameter, it should specify a function that looks like this: </p> <!-- Note: intentionally longer 80 columns --> <pre jstcache="0">function(<span jscontent="callbackSignature" jstcache="29">Type param1, Type param2</span>) <span class="subdued" jstcache="0">{...}</span>);</pre> <dl jstcache="0"> <div jsselect="callbackParameters" jstcache="30"> <dt jstcache="0"> <!-- Note: intentionally longer 80 columns --> <var jscontent="name" jstcache="8">paramName</var><em jstcache="0"> (<span jscontent="typeName" jstcache="22">paramType</span>)</em> </dt> <dd class="todo" jsdisplay="!$this.description" jstcache="26"> Undocumented. </dd> <dd jsdisplay="$this.description" jsvalues=".innerHTML:$this.description" jstcache="27"> Description of this parameter from the json schema. </dd> <!-- OBJECT PROPERTIES --> <dd jsdisplay="_propertyList" jstcache="28"> <dl jstcache="0"> <div jsselect="_propertyList" jstcache="32"> <dt jstcache="0"> <!-- Note: intentionally longer 80 columns --> <var jscontent="name" jstcache="8">paramName</var><em jstcache="0"> (<span class="optional" jsdisplay="optional" jstcache="31">optional </span><span jscontent="typeName" jstcache="22">paramType</span>)</em> </dt> <dd class="todo" jsdisplay="!$this.description" jstcache="26"> Undocumented. </dd> <dd jsdisplay="$this.description" jsvalues=".innerHTML:$this.description" jstcache="27"> Description of this parameter from the json schema. </dd> </div> </dl> </dd> </div> </dl> </div> </div> <!-- /description --> </div> <!-- /apiItem --> </div> <!-- /apiGroup --> <!-- EVENTS --> <div class="apiGroup" id="events" jstcache="0"> <a name="#events" jstcache="0"></a> <h2 id="events" jstcache="0">Events</h2> <!-- iterates over all events --> <div jsselect="events" class="apiItem" jstcache="6"> <a jsvalues=".name:'event-' + name" jstcache="9"></a> <h3 jscontent="name" jstcache="8">event name</h3> <div class="summary" jstcache="0"> <!-- Note: intentionally longer 80 columns --> <span class="subdued" jstcache="0">chrome.bookmarks.</span><span jscontent="name" jstcache="8">onEvent</span><span class="subdued" jstcache="0">.addListener</span>(function(<span jscontent="callSignature" jstcache="17">Type param1, Type param2</span>) <span class="subdued" jstcache="0">{...}</span>); </div> <div class="description" jstcache="0"> <p class="todo" jsdisplay="!description" jstcache="13">Undocumented.</p> <p jsdisplay="description" jsvalues=".innerHTML:description" jstcache="14"> A description from the json schema def of the event goes here. </p> <!-- PARAMETERS --> <h4 jstcache="0">Parameters</h4> <dl jstcache="0"> <div jsselect="parameters" jstcache="23"> <dt jstcache="0"> <!-- Note: intentionally longer 80 columns --> <var jscontent="name" jstcache="8">paramName</var><em jstcache="0"> (<span jscontent="typeName" jstcache="22">paramType</span>)</em> </dt> <dd class="todo" jsdisplay="!$this.description" jstcache="26">Undocumented.</dd> <dd jsdisplay="$this.description" jsvalues=".innerHTML:$this.description" jstcache="27"> Description of this parameter from the json schema. </dd> <!-- OBJECT PROPERTIES --> <dd jsdisplay="_propertyList" jstcache="28"> <dl jstcache="0"> <div jsselect="_propertyList" jstcache="32"> <dt jstcache="0"> <!-- Note: intentionally longer 80 columns --> <var jscontent="name" jstcache="8">paramName</var><em jstcache="0"> (<span class="optional" jsdisplay="optional" jstcache="31">optional </span><span jscontent="typeName" jstcache="22">paramType</span>)</em> </dt> <dd class="todo" jsdisplay="!$this.description" jstcache="26"> Undocumented. </dd> <dd jsdisplay="$this.description" jsvalues=".innerHTML:$this.description" jstcache="27"> Description of this parameter from the json schema. </dd> </div> </dl> </dd> </div> </dl> </div> <!-- /decription --> </div> <!-- /apiItem --> </div> <!-- /apiGroup --> </div> <!-- /apiPage --> </div> <!-- /mainColumn --> </div> <!-- /pageContent --> <div id="pageFooter" --="" jstcache="0"> Copyright 2009 <br jstcache="0"> TBD: copyright/license should be automatically included here </div> <!-- /pageFooter --> </div> <!-- /container --> </body></html>
|
