OLD | NEW |
| (Empty) |
1 <!DOCTYPE html><!-- This page is a placeholder for generated extensions api doc.
Note: | |
2 1) The <head> information in this page is significant, should be uniform | |
3 across api docs and should be edited only with knowledge of the | |
4 templating mechanism. | |
5 3) All <body>.innerHTML is genereated as an rendering step. If viewed in a | |
6 browser, it will be re-generated from the template, json schema and | |
7 authored overview content. | |
8 4) The <body>.innerHTML is also generated by an offline step so that this | |
9 page may easily be indexed by search engines. | |
10 --><html xmlns="http://www.w3.org/1999/xhtml"><head> | |
11 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> | |
12 <link href="css/ApiRefStyles.css" rel="stylesheet" type="text/css"> | |
13 <link href="css/print.css" rel="stylesheet" type="text/css" media="print"> | |
14 <script type="text/javascript" src="../../../third_party/jstemplate/jstempla
te_compiled.js"> | |
15 </script> | |
16 <script type="text/javascript" src="../../../../third_party/json_minify/mini
fy-sans-regexp.js"> | |
17 </script> | |
18 <script type="text/javascript" src="js/api_page_generator.js"></script> | |
19 <script type="text/javascript" src="js/bootstrap.js"></script> | |
20 <script type="text/javascript" src="js/sidebar.js"></script> | |
21 <meta name="description" content="Documentation for the chrome.webstore module
, which is part of the Google Chrome extension APIs."><title>chrome.webstore -
Google Chrome Extensions - Google Code</title></head> | |
22 <body> <div id="devModeWarning" class="displayModeWarning"> | |
23 You are viewing extension docs in chrome via the 'file:' scheme: are you exp
ecting to see local changes when you refresh? You'll need run chrome with --allo
w-file-access-from-files. | |
24 </div> | |
25 <div id="branchWarning" class="displayModeWarning"> | |
26 <span>WARNING: This is the <span id="branchName">BETA</span> documentation. | |
27 It may not work with the stable release of Chrome.</span> | |
28 <select id="branchChooser"> | |
29 <option>Choose a different version... | |
30 </option><option value="">Stable | |
31 </option><option value="beta">Beta | |
32 </option><option value="dev">Dev | |
33 </option><option value="trunk">Trunk | |
34 </option></select> | |
35 </div> | |
36 <div id="unofficialWarning" class="displayModeWarning"> | |
37 <span>WARNING: This is unofficial documentation. It may not work with the | |
38 current release of Chrome.</span> | |
39 <button id="goToOfficialDocs">Go to the official docs</button> | |
40 </div> | |
41 <div id="gc-container" class="labs"> | |
42 <!-- SUBTEMPLATES: DO NOT MOVE FROM THIS LOCATION --> | |
43 <!-- In particular, sub-templates that recurse, must be used by allowing | |
44 jstemplate to make a copy of the template in this section which | |
45 are not operated on by way of the jsskip="true" --> | |
46 <!-- /SUBTEMPLATES --> | |
47 <a id="top"></a> | |
48 <div id="skipto"> | |
49 <a href="#gc-pagecontent">Skip to page content</a> | |
50 <a href="#gc-toc">Skip to main navigation</a> | |
51 </div> | |
52 <!-- API HEADER --> | |
53 <table id="header" width="100%" cellspacing="0" border="0"> | |
54 <tbody><tr> | |
55 <td valign="middle"><a href="http://code.google.com/"><img src="images/c
ode_labs_logo.gif" height="43" width="161" alt="Google Code Labs" style="border:
0; margin:0;"></a></td> | |
56 <td valign="middle" width="100%" style="padding-left:0.6em;"> | |
57 <form action="http://www.google.com/cse" id="cse" style="margin-top:0.
5em"> | |
58 <div id="gsc-search-box"> | |
59 <input type="hidden" name="cx" value="002967670403910741006:61_cvz
fqtno"> | |
60 <input type="hidden" name="ie" value="UTF-8"> | |
61 <input type="text" name="q" value="" size="55"> | |
62 <input class="gsc-search-button" type="submit" name="sa" value="Se
arch"> | |
63 <br> | |
64 <span class="greytext">e.g. "page action" or "tabs"</span> | |
65 </div> | |
66 </form> | |
67 <script type="text/javascript" src="https://www.google.com/jsapi"></sc
ript> | |
68 <script type="text/javascript">google.load("elements", "1", {packages:
"transliteration"});</script> | |
69 <script type="text/javascript" src="https://www.google.com/coop/cse/t1
3n?form=cse&t13n_langs=en"></script> | |
70 <script type="text/javascript" src="https://www.google.com/coop/cse/br
and?form=cse&lang=en"></script> | |
71 </td> | |
72 </tr> | |
73 </tbody></table> | |
74 <div id="codesiteContent" class=""> | |
75 <a id="gc-topnav-anchor"></a> | |
76 <div id="gc-topnav"> | |
77 <h1>Google Chrome Extensions (<a href="http://code.google.com/labs/">Lab
s</a>)</h1> | |
78 <ul id="home" class="gc-topnav-tabs"> | |
79 <li id="home_link"> | |
80 <a href="index.html" title="Google Chrome Extensions home page">Home
</a> | |
81 </li> | |
82 <li id="docs_link"> | |
83 <a href="docs.html" title="Official Google Chrome Extensions documen
tation">Docs</a> | |
84 </li> | |
85 <li id="faq_link"> | |
86 <a href="faq.html" title="Answers to frequently asked questions abou
t Google Chrome Extensions">FAQ</a> | |
87 </li> | |
88 <li id="samples_link"> | |
89 <a href="samples.html" title="Sample extensions (with source code)">
Samples</a> | |
90 </li> | |
91 <li id="group_link"> | |
92 <a href="http://groups.google.com/a/chromium.org/group/chromium-exte
nsions" title="Google Chrome Extensions developer forum">Group</a> | |
93 </li> | |
94 <li id="so_link"> | |
95 <a href="http://stackoverflow.com/questions/tagged/google-chrome-ext
ension" title="[google-chrome-extension] tag on Stack Overflow">Questions?</a> | |
96 </li> | |
97 </ul> | |
98 </div> <!-- end gc-topnav --> | |
99 <div class="g-section g-tpl-170"> | |
100 <!-- SIDENAV --> | |
101 <div class="g-unit g-first" id="gc-toc"> | |
102 <ul> | |
103 <li><a href="getstarted.html">Getting Started</a></li> | |
104 <li><a href="overview.html">Overview</a></li> | |
105 <li><a href="whats_new.html">What's New?</a></li> | |
106 <li><h2><a href="devguide.html">Developer's Guide</a></h2> | |
107 <ul> | |
108 <li>Browser UI | |
109 <ul> | |
110 <li><a href="browserAction.html">Browser Actions</a></li> | |
111 <li><a href="contextMenus.html">Context Menus</a></li> | |
112 <li><a href="notifications.html">Desktop Notifications</a></li
> | |
113 <li><a href="omnibox.html">Omnibox</a></li> | |
114 <li><a href="options.html">Options Pages</a></li> | |
115 <li><a href="override.html">Override Pages</a></li> | |
116 <li><a href="pageAction.html">Page Actions</a></li> | |
117 </ul> | |
118 </li> | |
119 <li>Browser Interaction | |
120 <ul> | |
121 <li><a href="bookmarks.html">Bookmarks</a></li> | |
122 <li><a href="cookies.html">Cookies</a></li> | |
123 <li><a href="devtools.html">Developer Tools</a></li> | |
124 <li><a href="events.html">Events</a></li> | |
125 <li><a href="history.html">History</a></li> | |
126 <li><a href="management.html">Management</a></li> | |
127 <li><a href="tabs.html">Tabs</a></li> | |
128 <li><a href="windows.html">Windows</a></li> | |
129 </ul> | |
130 </li> | |
131 <li>Implementation | |
132 <ul> | |
133 <li><a href="a11y.html">Accessibility</a></li> | |
134 <li><a href="background_pages.html">Background Pages</a></li> | |
135 <li><a href="content_scripts.html">Content Scripts</a></li> | |
136 <li><a href="xhr.html">Cross-Origin XHR</a></li> | |
137 <li><a href="i18n.html">Internationalization</a></li> | |
138 <li><a href="messaging.html">Message Passing</a></li> | |
139 <li><a href="permissions.html">Optional Permissions</a></li> | |
140 <li><a href="npapi.html">NPAPI Plugins</a></li> | |
141 </ul> | |
142 </li> | |
143 <li>Finishing | |
144 <ul> | |
145 <li><a href="hosting.html">Hosting</a></li> | |
146 <li><a href="external_extensions.html">Other Deployment Option
s</a></li> | |
147 </ul> | |
148 </li> | |
149 </ul> | |
150 </li> | |
151 <li><h2><a href="apps.html">Packaged Apps</a></h2></li> | |
152 <li><h2><a href="tutorials.html">Tutorials</a></h2> | |
153 <ul> | |
154 <li><a href="tut_debugging.html">Debugging</a></li> | |
155 <li><a href="tut_analytics.html">Google Analytics</a></li> | |
156 <li><a href="tut_oauth.html">OAuth</a></li> | |
157 </ul> | |
158 </li> | |
159 <li><h2>Reference</h2> | |
160 <ul> | |
161 <li>Formats | |
162 <ul> | |
163 <li><a href="manifest.html">Manifest Files</a></li> | |
164 <li><a href="match_patterns.html">Match Patterns</a></li> | |
165 </ul> | |
166 </li> | |
167 <li><a href="permission_warnings.html">Permission Warnings</a></li
> | |
168 <li><a href="api_index.html">chrome.* APIs</a></li> | |
169 <li><a href="api_other.html">Other APIs</a></li> | |
170 </ul> | |
171 </li> | |
172 <li><h2><a href="samples.html">Samples</a></h2></li> | |
173 <div class="line"> </div> | |
174 <li><h2>More</h2> | |
175 <ul> | |
176 <li><a href="http://code.google.com/chrome/webstore/docs/index.htm
l">Chrome Web Store</a></li> | |
177 <li><a href="http://code.google.com/chrome/apps/docs/developers_gu
ide.html">Hosted Apps</a></li> | |
178 <li><a href="themes.html">Themes</a></li> | |
179 </ul> | |
180 </li> | |
181 </ul> | |
182 </div> | |
183 <script> | |
184 initToggles(); | |
185 </script> | |
186 <div class="g-unit" id="gc-pagecontent"> | |
187 <div id="pageTitle"> | |
188 <h1 class="page_title">chrome.webstore</h1> | |
189 </div> | |
190 <!-- TABLE OF CONTENTS --> | |
191 <div id="toc"> | |
192 <h2>Contents</h2> | |
193 <ol> | |
194 <li> | |
195 <a href="#apiReference">API reference: chrome.webstore</a> | |
196 <ol> | |
197 <li> | |
198 <a href="#global-methods">Methods</a> | |
199 <ol> | |
200 <li> | |
201 <a href="#method-install">install</a> | |
202 </li> | |
203 </ol> | |
204 </li> | |
205 </ol> | |
206 </li> | |
207 </ol> | |
208 </div> | |
209 <!-- /TABLE OF CONTENTS --> | |
210 <!-- Standard content lead-in for experimental API pages --> | |
211 <!-- STATIC CONTENT PLACEHOLDER --> | |
212 <div id="static"></div> | |
213 <!-- API PAGE --> | |
214 <div class="apiPage"> | |
215 <a name="apiReference"></a> | |
216 <h2>API reference: chrome.webstore</h2> | |
217 <!-- PROPERTIES --> | |
218 <!-- /apiGroup --> | |
219 <!-- METHODS --> | |
220 <div id="methodsTemplate" class="apiGroup"> | |
221 <a name="global-methods"></a> | |
222 <h3>Methods</h3> | |
223 <!-- iterates over all functions --> | |
224 <div class="apiItem"> | |
225 <a name="method-install"></a> <!-- method-anchor --> | |
226 <h4>install</h4> | |
227 <div class="summary"> | |
228 <!-- Note: intentionally longer 80 columns --> | |
229 <span>chrome.webstore.install</span>(<span class="optional"><s
pan>string</span> | |
230 <var><span>url</span></var></span><span class="optional"><
span>, </span><span>function</span> | |
231 <var><span>successCallback</span></var></span><span class=
"optional"><span>, </span><span>function</span> | |
232 <var><span>failureCallback</span></var></span>)</div> | |
233 <div class="description"> | |
234 <!-- PARAMETERS --> | |
235 <h4>Parameters</h4> | |
236 <dl> | |
237 <div> | |
238 <div> | |
239 <dt> | |
240 <var>url</var> | |
241 <em> | |
242 <!-- TYPE --> | |
243 <div style="display:inline"> | |
244 ( | |
245 <span class="optional">optional</span> | |
246 <span id="typeTemplate"> | |
247 <span> | |
248 <span>string</span> | |
249 </span> | |
250 </span> | |
251 ) | |
252 </div> | |
253 </em> | |
254 </dt> | |
255 <dd>If you have more than one <code><link></code> tag on your pa
ge with the <code>chrome-webstore-item</code> relation, you can choose which ite
m you'd like to install by passing in its URL here. If it is omitted, then the f
irst (or only) link will be used. An exception will be thrown if the passed in U
RL does not exist on the page.</dd> | |
256 <!-- OBJECT PROPERTIES --> | |
257 <!-- OBJECT METHODS --> | |
258 <!-- OBJECT EVENT FIELDS --> | |
259 <!-- FUNCTION PARAMETERS --> | |
260 </div> | |
261 </div><div> | |
262 <div> | |
263 <dt> | |
264 <var>successCallback</var> | |
265 <em> | |
266 <!-- TYPE --> | |
267 <div style="display:inline"> | |
268 ( | |
269 <span class="optional">optional</span> | |
270 <span id="typeTemplate"> | |
271 <span> | |
272 <span>function</span> | |
273 </span> | |
274 </span> | |
275 ) | |
276 </div> | |
277 </em> | |
278 </dt> | |
279 <dd>This function is invoked when inline installation successfully com
pletes (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.</dd> | |
280 <!-- OBJECT PROPERTIES --> | |
281 <!-- OBJECT METHODS --> | |
282 <!-- OBJECT EVENT FIELDS --> | |
283 <!-- FUNCTION PARAMETERS --> | |
284 <dd> | |
285 </dd> | |
286 </div> | |
287 </div><div> | |
288 <div> | |
289 <dt> | |
290 <var>failureCallback</var> | |
291 <em> | |
292 <!-- TYPE --> | |
293 <div style="display:inline"> | |
294 ( | |
295 <span class="optional">optional</span> | |
296 <span id="typeTemplate"> | |
297 <span> | |
298 <span>function</span> | |
299 </span> | |
300 </span> | |
301 ) | |
302 </div> | |
303 </em> | |
304 </dt> | |
305 <dd>This function is invoked when inline installation does not success
fully 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 fr
om a non-verified site.</dd> | |
306 <!-- OBJECT PROPERTIES --> | |
307 <!-- OBJECT METHODS --> | |
308 <!-- OBJECT EVENT FIELDS --> | |
309 <!-- FUNCTION PARAMETERS --> | |
310 <dd> | |
311 <div> | |
312 <h5>Parameters</h5> | |
313 <dl> | |
314 <div> | |
315 <div> | |
316 <dt> | |
317 <var>error</var> | |
318 <em> | |
319 <!-- TYPE --> | |
320 <div style="display:inline"> | |
321 ( | |
322 <span id="typeTemplate"> | |
323 <span> | |
324 <span>string</span> | |
325 </span> | |
326 </span> | |
327 ) | |
328 </div> | |
329 </em> | |
330 </dt> | |
331 <dd>The failure detail. You may wish to inspect or log this for debugg
ing purposes, but you should not rely on specific strings being passed back.</dd
> | |
332 <!-- OBJECT PROPERTIES --> | |
333 <!-- OBJECT METHODS --> | |
334 <!-- OBJECT EVENT FIELDS --> | |
335 <!-- FUNCTION PARAMETERS --> | |
336 </div> | |
337 </div> | |
338 </dl> | |
339 </div> | |
340 </dd> | |
341 </div> | |
342 </div> | |
343 </dl> | |
344 <!-- RETURNS --> | |
345 <dl> | |
346 </dl> | |
347 <!-- CALLBACK --> | |
348 <div> | |
349 <div> | |
350 <h4>Callback function</h4> | |
351 <p> | |
352 If you specify the <em>callback</em> parameter, it should | |
353 specify a function that looks like this: | |
354 </p> | |
355 <!-- Note: intentionally longer 80 columns --> | |
356 <pre>function(<span>string error</span>) <span class="subdued"
>{...}</span>;</pre> | |
357 <dl> | |
358 <div> | |
359 <div> | |
360 <dt> | |
361 <var>error</var> | |
362 <em> | |
363 <!-- TYPE --> | |
364 <div style="display:inline"> | |
365 ( | |
366 <span id="typeTemplate"> | |
367 <span> | |
368 <span>string</span> | |
369 </span> | |
370 </span> | |
371 ) | |
372 </div> | |
373 </em> | |
374 </dt> | |
375 <dd>The failure detail. You may wish to inspect or log this for debugg
ing purposes, but you should not rely on specific strings being passed back.</dd
> | |
376 <!-- OBJECT PROPERTIES --> | |
377 <!-- OBJECT METHODS --> | |
378 <!-- OBJECT EVENT FIELDS --> | |
379 <!-- FUNCTION PARAMETERS --> | |
380 </div> | |
381 </div> | |
382 </dl> | |
383 </div> | |
384 </div> | |
385 <!-- MIN_VERSION --> | |
386 </div> <!-- /description --> | |
387 </div> <!-- /apiItem --> | |
388 </div> <!-- /apiGroup --> | |
389 <!-- EVENTS --> | |
390 <!-- /apiGroup --> | |
391 <!-- TYPES --> | |
392 <!-- /apiGroup --> | |
393 </div> <!-- /apiPage --> | |
394 </div> <!-- /gc-pagecontent --> | |
395 </div> <!-- /g-section --> | |
396 </div> <!-- /codesiteContent --> | |
397 <div id="gc-footer" --=""> | |
398 <div class="text"> | |
399 <p> | |
400 Except as otherwise <a href="http://code.google.com/policies.html#restrictions
">noted</a>, | |
401 the content of this page is licensed under the <a rel="license" href="http://c
reativecommons.org/licenses/by/3.0/">Creative Commons | |
402 Attribution 3.0 License</a>, and code samples are licensed under the | |
403 <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD Lic
ense</a>. | |
404 </p> | |
405 <p> | |
406 ©2011 Google | |
407 </p> | |
408 <!-- begin analytics --> | |
409 <script src="https://www.google-analytics.com/urchin.js" type="text/javascript">
</script> | |
410 <script src="https://www.google-analytics.com/ga.js" type="text/javascript"></sc
ript> | |
411 <script type="text/javascript"> | |
412 // chrome doc tracking | |
413 try { | |
414 var engdocs = _gat._getTracker("YT-10763712-2"); | |
415 engdocs._trackPageview(); | |
416 } catch(err) {} | |
417 // code.google.com site-wide tracking | |
418 try { | |
419 _uacct="UA-18071-1"; | |
420 _uanchor=1; | |
421 _uff=0; | |
422 urchinTracker(); | |
423 } | |
424 catch(e) {/* urchinTracker not available. */} | |
425 </script> | |
426 <!-- end analytics --> | |
427 </div> | |
428 </div> <!-- /gc-footer --> | |
429 </div> <!-- /gc-container --> | |
430 </body></html> | |
OLD | NEW |