Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(21)

Side by Side Diff: chrome/common/extensions/docs/experimental.storage.html

Issue 9274004: Take the Extension Storage API out of experimental. (Closed) Base URL: svn://svn.chromium.org/chrome/trunk/src
Patch Set: . Created 8 years, 11 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch | Annotate | Revision Log
OLDNEW
(Empty)
1 <!DOCTYPE html><!-- This page is a placeholder for generated extensions api doc. Note:
Aaron Boodman 2012/01/23 01:51:33 It's traditional to leave a page here redirecting
not at google - send to devlin 2012/01/23 03:59:24 Done. I don't think webNavigation is an example t
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="js/api_page_generator.js"></script>
17 <script type="text/javascript" src="js/bootstrap.js"></script>
18 <script type="text/javascript" src="js/sidebar.js"></script>
19 <meta name="description" content="Documentation for the chrome.experimental.st orage module, which is part of the Google Chrome extension APIs."><title>chrome .experimental.storage - Google Chrome Extensions - Google Code</title></head>
20 <body> <div id="gc-container" class="labs">
21 <div id="devModeWarning">
22 You are viewing extension docs in chrome via the 'file:' scheme: are you expecting to see local changes when you refresh? You'll need run chrome with -- allow-file-access-from-files.
23 </div>
24 <!-- SUBTEMPLATES: DO NOT MOVE FROM THIS LOCATION -->
25 <!-- In particular, sub-templates that recurse, must be used by allowing
26 jstemplate to make a copy of the template in this section which
27 are not operated on by way of the jsskip="true" -->
28 <div style="display:none">
29
30 <!-- VALUE -->
31 <div id="valueTemplate">
32 <dt>
33 <var>paramName</var>
34 <em>
35
36 <!-- TYPE -->
37 <div style="display:inline">
38 (
39 <span class="optional">optional</span>
40 <span class="enum">enumerated</span>
41 <span id="typeTemplate">
42 <span>
43 <a> Type</a>
44 </span>
45 <span>
46 <span>
47 array of <span><span></span></span>
48 </span>
49 <span>paramType</span>
50 <span></span>
51 </span>
52 </span>
53 )
54 </div>
55
56 </em>
57 </dt>
58 <dd class="todo">
59 Undocumented.
60 </dd>
61 <dd>
62 Description of this parameter from the json schema.
63 </dd>
64 <dd>
65 This parameter was added in version
66 <b><span></span></b>.
67 You must omit this parameter in earlier versions,
68 and you may omit it in any version. If you require this
69 parameter, the manifest key
70 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
71 can ensure that your extension won't be run in an earlier browser ve rsion.
72 </dd>
73
74 <!-- OBJECT PROPERTIES -->
75 <dd>
76 <dl>
77 <div>
78 <div>
79 </div>
80 </div>
81 </dl>
82 </dd>
83
84 <!-- OBJECT METHODS -->
85 <dd>
86 <div></div>
87 </dd>
88
89 <!-- OBJECT EVENT FIELDS -->
90 <dd>
91 <div></div>
92 </dd>
93
94 <!-- FUNCTION PARAMETERS -->
95 <dd>
96 <div></div>
97 </dd>
98
99 </div> <!-- /VALUE -->
100
101 <div id="functionParametersTemplate">
102 <h5>Parameters</h5>
103 <dl>
104 <div>
105 <div>
106 </div>
107 </div>
108 </dl>
109 </div>
110
111 <!-- Individual subsections from the table of contents -->
112 <ol>
113 <li id="propertiesTocTemplate">
114 <a href="#properties">Properties</a>
115 <ol>
116 <li>
117 <a href="#property-anchor">propertyName</a>
118 </li>
119 </ol>
120 </li>
121 <li id="methodsTocTemplate">
122 <a>Methods</a>
123 <ol>
124 <li>
125 <a href="#method-anchor">methodName</a>
126 </li>
127 </ol>
128 </li>
129 <li id="eventsTocTemplate">
130 <a>Events</a>
131 <ol>
132 <li>
133 <a href="#event-anchor">eventName</a>
134 </li>
135 </ol>
136 </li>
137 <li id="typesTocTemplate">
138 <a href="#types">Types</a>
139 <ol>
140 <li>
141 <a href="#id-anchor">id</a>
142 <ol>
143 <div></div>
144 <div></div>
145 </ol>
146 </li>
147 </ol>
148 </li>
149 </ol>
150 </div> <!-- /SUBTEMPLATES -->
151
152 <a id="top"></a>
153 <div id="skipto">
154 <a href="#gc-pagecontent">Skip to page content</a>
155 <a href="#gc-toc">Skip to main navigation</a>
156 </div>
157 <!-- API HEADER -->
158 <table id="header" width="100%" cellspacing="0" border="0">
159 <tbody><tr>
160 <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>
161 <td valign="middle" width="100%" style="padding-left:0.6em;">
162 <form action="http://www.google.com/cse" id="cse" style="margin-top:0. 5em">
163 <div id="gsc-search-box">
164 <input type="hidden" name="cx" value="002967670403910741006:61_cvz fqtno">
165 <input type="hidden" name="ie" value="UTF-8">
166 <input type="text" name="q" value="" size="55">
167 <input class="gsc-search-button" type="submit" name="sa" value="Se arch">
168 <br>
169 <span class="greytext">e.g. "page action" or "tabs"</span>
170 </div>
171 </form>
172
173 <script type="text/javascript" src="https://www.google.com/jsapi"></sc ript>
174 <script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script>
175 <script type="text/javascript" src="https://www.google.com/coop/cse/t1 3n?form=cse&amp;t13n_langs=en"></script>
176 <script type="text/javascript" src="https://www.google.com/coop/cse/br and?form=cse&amp;lang=en"></script>
177 </td>
178 </tr>
179 </tbody></table>
180
181 <div id="codesiteContent" class="">
182
183 <a id="gc-topnav-anchor"></a>
184 <div id="gc-topnav">
185 <h1>Google Chrome Extensions (<a href="http://code.google.com/labs/">Lab s</a>)</h1>
186 <ul id="home" class="gc-topnav-tabs">
187 <li id="home_link">
188 <a href="index.html" title="Google Chrome Extensions home page">Home </a>
189 </li>
190 <li id="docs_link">
191 <a href="docs.html" title="Official Google Chrome Extensions documen tation">Docs</a>
192 </li>
193 <li id="faq_link">
194 <a href="faq.html" title="Answers to frequently asked questions abou t Google Chrome Extensions">FAQ</a>
195 </li>
196 <li id="samples_link">
197 <a href="samples.html" title="Sample extensions (with source code)"> Samples</a>
198 </li>
199 <li id="group_link">
200 <a href="http://groups.google.com/a/chromium.org/group/chromium-exte nsions" title="Google Chrome Extensions developer forum">Group</a>
201 </li>
202 <li id="so_link">
203 <a href="http://stackoverflow.com/questions/tagged/google-chrome-ext ension" title="[google-chrome-extension] tag on Stack Overflow">Questions?</a>
204 </li>
205 </ul>
206 </div> <!-- end gc-topnav -->
207
208 <div class="g-section g-tpl-170">
209 <!-- SIDENAV -->
210 <div class="g-unit g-first" id="gc-toc">
211 <ul>
212 <li><a href="getstarted.html">Getting Started</a></li>
213 <li><a href="overview.html">Overview</a></li>
214 <li><a href="whats_new.html">What's New?</a></li>
215 <li><h2><a href="devguide.html">Developer's Guide</a></h2>
216 <ul>
217 <li>Browser UI
218 <ul>
219 <li><a href="browserAction.html">Browser Actions</a></li>
220 <li><a href="contextMenus.html">Context Menus</a></li>
221 <li><a href="notifications.html">Desktop Notifications</a></li >
222 <li><a href="omnibox.html">Omnibox</a></li>
223 <li><a href="options.html">Options Pages</a></li>
224 <li><a href="override.html">Override Pages</a></li>
225 <li><a href="pageAction.html">Page Actions</a></li>
226 </ul>
227 </li>
228 <li>Browser Interaction
229 <ul>
230 <li><a href="bookmarks.html">Bookmarks</a></li>
231 <li><a href="cookies.html">Cookies</a></li>
232 <li><a href="devtools.html">Developer Tools</a></li>
233 <li><a href="events.html">Events</a></li>
234 <li><a href="history.html">History</a></li>
235 <li><a href="management.html">Management</a></li>
236 <li><a href="tabs.html">Tabs</a></li>
237 <li><a href="windows.html">Windows</a></li>
238 </ul>
239 </li>
240 <li>Implementation
241 <ul>
242 <li><a href="a11y.html">Accessibility</a></li>
243 <li><a href="background_pages.html">Background Pages</a></li>
244 <li><a href="content_scripts.html">Content Scripts</a></li>
245 <li><a href="xhr.html">Cross-Origin XHR</a></li>
246 <li><a href="i18n.html">Internationalization</a></li>
247 <li><a href="messaging.html">Message Passing</a></li>
248 <li><a href="permissions.html">Optional Permissions</a></li>
249 <li><a href="npapi.html">NPAPI Plugins</a></li>
250 </ul>
251 </li>
252 <li>Finishing
253 <ul>
254 <li><a href="hosting.html">Hosting</a></li>
255 <li><a href="external_extensions.html">Other Deployment Option s</a></li>
256 </ul>
257 </li>
258 </ul>
259 </li>
260 <li><h2><a href="apps.html">Packaged Apps</a></h2></li>
261 <li><h2><a href="tutorials.html">Tutorials</a></h2>
262 <ul>
263 <li><a href="tut_debugging.html">Debugging</a></li>
264 <li><a href="tut_analytics.html">Google Analytics</a></li>
265 <li><a href="tut_oauth.html">OAuth</a></li>
266 </ul>
267 </li>
268 <li><h2>Reference</h2>
269 <ul>
270 <li>Formats
271 <ul>
272 <li><a href="manifest.html">Manifest Files</a></li>
273 <li><a href="match_patterns.html">Match Patterns</a></li>
274 </ul>
275 </li>
276 <li><a href="permission_warnings.html">Permission Warnings</a></li >
277 <li><a href="api_index.html">chrome.* APIs</a></li>
278 <li><a href="api_other.html">Other APIs</a></li>
279 </ul>
280 </li>
281 <li><h2><a href="samples.html">Samples</a></h2></li>
282 <div class="line"> </div>
283 <li><h2>More</h2>
284 <ul>
285 <li><a href="http://code.google.com/chrome/webstore/docs/index.htm l">Chrome Web Store</a></li>
286 <li><a href="http://code.google.com/chrome/apps/docs/developers_gu ide.html">Hosted Apps</a></li>
287 <li><a href="themes.html">Themes</a></li>
288 </ul>
289 </li>
290 </ul>
291 </div>
292 <script>
293 initToggles();
294 </script>
295
296 <div class="g-unit" id="gc-pagecontent">
297 <div id="pageTitle">
298 <h1 class="page_title">chrome.experimental.storage</h1>
299 </div>
300 <!-- TABLE OF CONTENTS -->
301 <div id="toc">
302 <h2>Contents</h2>
303 <ol>
304 <li style="display: none; ">
305 <a>h2Name</a>
306 <ol>
307 <li>
308 <a>h3Name</a>
309 </li>
310 </ol>
311 </li>
312 <li>
313 <a href="#apiReference">API reference: chrome.experimental.stora ge</a>
314 <ol>
315 <li>
316 <a href="#properties">Properties</a>
317 <ol>
318 <li>
319 <a href="#property-sync">sync</a>
320 </li><li>
321 <a href="#property-local">local</a>
322 </li>
323 </ol>
324 </li>
325 <li style="display: none; ">
326 <a>Methods</a>
327 <ol>
328 <li>
329 <a href="#method-anchor">methodName</a>
330 </li>
331 </ol>
332 </li>
333 <li>
334 <a href="#global-events">Events</a>
335 <ol>
336 <li>
337 <a href="#event-onChanged">onChanged</a>
338 </li>
339 </ol>
340 </li>
341 <li>
342 <a href="#types">Types</a>
343 <ol>
344 <li>
345 <a href="#type-StorageChange">StorageChange</a>
346 <ol>
347 <li style="display: none; ">
348 <a>Methods</a>
349 <ol>
350 <li>
351 <a href="#method-anchor">methodName</a>
352 </li>
353 </ol>
354 </li>
355 <li style="display: none; ">
356 <a>Events</a>
357 <ol>
358 <li>
359 <a href="#event-anchor">eventName</a>
360 </li>
361 </ol>
362 </li>
363 </ol>
364 </li><li>
365 <a href="#type-StorageNamespace">StorageNamespace</a>
366 <ol>
367 <li>
368 <a href="#global-StorageNamespace-methods">Methods</a>
369 <ol>
370 <li>
371 <a href="#method-StorageNamespace-clear">clear</a>
372 </li><li>
373 <a href="#method-StorageNamespace-get">get</a>
374 </li><li>
375 <a href="#method-StorageNamespace-remove">remove</a>
376 </li><li>
377 <a href="#method-StorageNamespace-set">set</a>
378 </li>
379 </ol>
380 </li>
381 <li style="display: none; ">
382 <a>Events</a>
383 <ol>
384 <li>
385 <a href="#event-anchor">eventName</a>
386 </li>
387 </ol>
388 </li>
389 </ol>
390 </li>
391 </ol>
392 </li>
393 </ol>
394 </li>
395 </ol>
396 </div>
397 <!-- /TABLE OF CONTENTS -->
398
399 <!-- Standard content lead-in for experimental API pages -->
400 <p id="classSummary">
401 For information on how to use experimental APIs, see the <a href="expe rimental.html">chrome.experimental.* APIs</a> page.
402 </p>
403
404 <!-- STATIC CONTENT PLACEHOLDER -->
405 <div id="static"></div>
406
407 <!-- API PAGE -->
408 <div class="apiPage">
409 <a name="apiReference"></a>
410 <h2>API reference: chrome.experimental.storage</h2>
411
412 <!-- PROPERTIES -->
413 <div class="apiGroup">
414 <a name="properties"></a>
415 <h3 id="properties">Properties</h3>
416
417 <div>
418 <a name="property-sync"></a>
419 <h4>sync</h4>
420 <div class="summary">
421 <!-- Note: intentionally longer 80 columns -->
422 <span>chrome.experimental.storage.</span><span>sync</span>
423 </div>
424 <div>
425 <dt>
426 <var>sync</var>
427 <em>
428
429 <!-- TYPE -->
430 <div style="display:inline">
431 (
432 <span class="optional" style="display: none; ">optional</spa n>
433 <span class="enum" style="display: none; ">enumerated</span>
434 <span id="typeTemplate">
435 <span>
436 <a href="experimental.storage.html#type-StorageNamespace ">StorageNamespace</a>
437 </span>
438 <span style="display: none; ">
439 <span>
440 array of <span><span></span></span>
441 </span>
442 <span>paramType</span>
443 <span></span>
444 </span>
445 </span>
446 )
447 </div>
448
449 </em>
450 </dt>
451 <dd class="todo" style="display: none; ">
452 Undocumented.
453 </dd>
454 <dd>Items under the "sync" namespace are synced using Chrome Sync.</dd >
455 <dd style="display: none; ">
456 This parameter was added in version
457 <b><span></span></b>.
458 You must omit this parameter in earlier versions,
459 and you may omit it in any version. If you require this
460 parameter, the manifest key
461 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
462 can ensure that your extension won't be run in an earlier browser ve rsion.
463 </dd>
464
465 <!-- OBJECT PROPERTIES -->
466 <dd style="display: none; ">
467 <dl>
468 <div>
469 <div>
470 </div>
471 </div>
472 </dl>
473 </dd>
474
475 <!-- OBJECT METHODS -->
476 <dd style="display: none; ">
477 <div></div>
478 </dd>
479
480 <!-- OBJECT EVENT FIELDS -->
481 <dd style="display: none; ">
482 <div></div>
483 </dd>
484
485 <!-- FUNCTION PARAMETERS -->
486 <dd style="display: none; ">
487 <div></div>
488 </dd>
489
490 </div>
491 </div><div>
492 <a name="property-local"></a>
493 <h4>local</h4>
494 <div class="summary">
495 <!-- Note: intentionally longer 80 columns -->
496 <span>chrome.experimental.storage.</span><span>local</span>
497 </div>
498 <div>
499 <dt>
500 <var>local</var>
501 <em>
502
503 <!-- TYPE -->
504 <div style="display:inline">
505 (
506 <span class="optional" style="display: none; ">optional</spa n>
507 <span class="enum" style="display: none; ">enumerated</span>
508 <span id="typeTemplate">
509 <span>
510 <a href="experimental.storage.html#type-StorageNamespace ">StorageNamespace</a>
511 </span>
512 <span style="display: none; ">
513 <span>
514 array of <span><span></span></span>
515 </span>
516 <span>paramType</span>
517 <span></span>
518 </span>
519 </span>
520 )
521 </div>
522
523 </em>
524 </dt>
525 <dd class="todo" style="display: none; ">
526 Undocumented.
527 </dd>
528 <dd>Items under the "local" namespace are local to each machine.</dd>
529 <dd style="display: none; ">
530 This parameter was added in version
531 <b><span></span></b>.
532 You must omit this parameter in earlier versions,
533 and you may omit it in any version. If you require this
534 parameter, the manifest key
535 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
536 can ensure that your extension won't be run in an earlier browser ve rsion.
537 </dd>
538
539 <!-- OBJECT PROPERTIES -->
540 <dd style="display: none; ">
541 <dl>
542 <div>
543 <div>
544 </div>
545 </div>
546 </dl>
547 </dd>
548
549 <!-- OBJECT METHODS -->
550 <dd style="display: none; ">
551 <div></div>
552 </dd>
553
554 <!-- OBJECT EVENT FIELDS -->
555 <dd style="display: none; ">
556 <div></div>
557 </dd>
558
559 <!-- FUNCTION PARAMETERS -->
560 <dd style="display: none; ">
561 <div></div>
562 </dd>
563
564 </div>
565 </div>
566
567 </div> <!-- /apiGroup -->
568
569 <!-- METHODS -->
570 <div id="methodsTemplate" class="apiGroup" style="display: none; ">
571 <a></a>
572 <h3>Methods</h3>
573
574 <!-- iterates over all functions -->
575 <div class="apiItem">
576 <a></a> <!-- method-anchor -->
577 <h4>method name</h4>
578
579 <div class="summary"><span>void</span>
580 <!-- Note: intentionally longer 80 columns -->
581 <span>chrome.module.methodName</span>(<span><span>, </span><sp an></span>
582 <var><span></span></var></span>)</div>
583
584 <div class="description">
585 <p class="todo">Undocumented.</p>
586 <p>
587 A description from the json schema def of the function goes he re.
588 </p>
589
590 <!-- PARAMETERS -->
591 <h4>Parameters</h4>
592 <dl>
593 <div>
594 <div>
595 </div>
596 </div>
597 </dl>
598
599 <!-- RETURNS -->
600 <h4>Returns</h4>
601 <dl>
602 <div>
603 <div>
604 </div>
605 </div>
606 </dl>
607
608 <!-- CALLBACK -->
609 <div>
610 <div>
611 <h4>Callback function</h4>
612 <p>
613 The callback <em>parameter</em> should specify a function
614 that looks like this:
615 </p>
616 <p>
617 If you specify the <em>callback</em> parameter, it should
618 specify a function that looks like this:
619 </p>
620
621 <!-- Note: intentionally longer 80 columns -->
622 <pre>function(<span>Type param1, Type param2</span>) <span cla ss="subdued">{...}</span>;</pre>
623 <dl>
624 <div>
625 <div>
626 </div>
627 </div>
628 </dl>
629 </div>
630 </div>
631
632 <!-- MIN_VERSION -->
633 <p>
634 This function was added in version <b><span></span></b>.
635 If you require this function, the manifest key
636 <a href="manifest.html#minimum_chrome_version">minimum_chrome_ version</a>
637 can ensure that your extension won't be run in an earlier brow ser version.
638 </p>
639 </div> <!-- /description -->
640
641 </div> <!-- /apiItem -->
642
643 </div> <!-- /apiGroup -->
644
645 <!-- EVENTS -->
646 <div id="eventsTemplate" class="apiGroup">
647 <a name="global-events"></a>
648 <h3>Events</h3>
649 <!-- iterates over all events -->
650 <div class="apiItem">
651 <a name="event-onChanged"></a>
652 <h4>onChanged</h4>
653
654 <div class="summary">
655 <!-- Note: intentionally longer 80 columns -->
656 <span class="subdued">chrome.experimental.storage.</span><span>o nChanged</span><span class="subdued">.addListener</span>(function(<span>object c hanges, string namespace</span>) <span class="subdued">{...}</span><span></span> );
657 </div>
658
659 <div class="description">
660 <p class="todo" style="display: none; ">Undocumented.</p>
661 <p>Fired when one or more items change.</p>
662
663 <!-- LISTENER PARAMETERS -->
664 <div>
665 <h4>Listener parameters</h4>
666 <dl>
667 <div>
668 <div>
669 <dt>
670 <var>changes</var>
671 <em>
672
673 <!-- TYPE -->
674 <div style="display:inline">
675 (
676 <span class="optional" style="display: none; ">optional</spa n>
677 <span class="enum" style="display: none; ">enumerated</span>
678 <span id="typeTemplate">
679 <span style="display: none; ">
680 <a> Type</a>
681 </span>
682 <span>
683 <span style="display: none; ">
684 array of <span><span></span></span>
685 </span>
686 <span>object</span>
687 <span style="display: none; "></span>
688 </span>
689 </span>
690 )
691 </div>
692
693 </em>
694 </dt>
695 <dd class="todo" style="display: none; ">
696 Undocumented.
697 </dd>
698 <dd>Object mapping each key that changed to its corresponding <a href= "#type-StorageChange">StorageChange</a> for that item.</dd>
699 <dd style="display: none; ">
700 This parameter was added in version
701 <b><span></span></b>.
702 You must omit this parameter in earlier versions,
703 and you may omit it in any version. If you require this
704 parameter, the manifest key
705 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
706 can ensure that your extension won't be run in an earlier browser ve rsion.
707 </dd>
708
709 <!-- OBJECT PROPERTIES -->
710 <dd>
711 <dl>
712 <div style="display: none; ">
713 <div>
714 </div>
715 </div>
716 </dl>
717 </dd>
718
719 <!-- OBJECT METHODS -->
720 <dd style="display: none; ">
721 <div></div>
722 </dd>
723
724 <!-- OBJECT EVENT FIELDS -->
725 <dd style="display: none; ">
726 <div></div>
727 </dd>
728
729 <!-- FUNCTION PARAMETERS -->
730 <dd style="display: none; ">
731 <div></div>
732 </dd>
733
734 </div>
735 </div><div>
736 <div>
737 <dt>
738 <var>namespace</var>
739 <em>
740
741 <!-- TYPE -->
742 <div style="display:inline">
743 (
744 <span class="optional" style="display: none; ">optional</spa n>
745 <span class="enum" style="display: none; ">enumerated</span>
746 <span id="typeTemplate">
747 <span style="display: none; ">
748 <a> Type</a>
749 </span>
750 <span>
751 <span style="display: none; ">
752 array of <span><span></span></span>
753 </span>
754 <span>string</span>
755 <span style="display: none; "></span>
756 </span>
757 </span>
758 )
759 </div>
760
761 </em>
762 </dt>
763 <dd class="todo" style="display: none; ">
764 Undocumented.
765 </dd>
766 <dd>The namespace ("sync" or "local") of the storage area the changes are for.</dd>
767 <dd style="display: none; ">
768 This parameter was added in version
769 <b><span></span></b>.
770 You must omit this parameter in earlier versions,
771 and you may omit it in any version. If you require this
772 parameter, the manifest key
773 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
774 can ensure that your extension won't be run in an earlier browser ve rsion.
775 </dd>
776
777 <!-- OBJECT PROPERTIES -->
778 <dd style="display: none; ">
779 <dl>
780 <div>
781 <div>
782 </div>
783 </div>
784 </dl>
785 </dd>
786
787 <!-- OBJECT METHODS -->
788 <dd style="display: none; ">
789 <div></div>
790 </dd>
791
792 <!-- OBJECT EVENT FIELDS -->
793 <dd style="display: none; ">
794 <div></div>
795 </dd>
796
797 <!-- FUNCTION PARAMETERS -->
798 <dd style="display: none; ">
799 <div></div>
800 </dd>
801
802 </div>
803 </div>
804 </dl>
805 </div>
806
807 <!-- EXTRA PARAMETERS -->
808 <div style="display: none; ">
809 <h4>Extra parameters to addListener</h4>
810 <dl>
811 <div>
812 <div>
813 </div>
814 </div>
815 </dl>
816 </div>
817
818 <!-- LISTENER RETURN VALUE -->
819 <h4 style="display: none; ">Listener returns</h4>
820 <dl>
821 <div style="display: none; ">
822 <div>
823 </div>
824 </div>
825 </dl>
826
827 </div> <!-- /description -->
828 </div> <!-- /apiItem -->
829
830 </div> <!-- /apiGroup -->
831
832 <!-- TYPES -->
833 <div class="apiGroup">
834 <a name="types"></a>
835 <h3 id="types">Types</h3>
836
837 <!-- iterates over all types -->
838 <div class="apiItem">
839 <a name="type-StorageChange"></a>
840 <h4>StorageChange</h4>
841
842 <div>
843 <dt>
844 <var style="display: none; ">paramName</var>
845 <em>
846
847 <!-- TYPE -->
848 <div style="display:inline">
849 (
850 <span class="optional" style="display: none; ">optional</spa n>
851 <span class="enum" style="display: none; ">enumerated</span>
852 <span id="typeTemplate">
853 <span style="display: none; ">
854 <a> Type</a>
855 </span>
856 <span>
857 <span style="display: none; ">
858 array of <span><span></span></span>
859 </span>
860 <span>object</span>
861 <span style="display: none; "></span>
862 </span>
863 </span>
864 )
865 </div>
866
867 </em>
868 </dt>
869 <dd class="todo">
870 Undocumented.
871 </dd>
872 <dd style="display: none; ">
873 Description of this parameter from the json schema.
874 </dd>
875 <dd style="display: none; ">
876 This parameter was added in version
877 <b><span></span></b>.
878 You must omit this parameter in earlier versions,
879 and you may omit it in any version. If you require this
880 parameter, the manifest key
881 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
882 can ensure that your extension won't be run in an earlier browser ve rsion.
883 </dd>
884
885 <!-- OBJECT PROPERTIES -->
886 <dd>
887 <dl>
888 <div>
889 <div>
890 <dt>
891 <var>oldValue</var>
892 <em>
893
894 <!-- TYPE -->
895 <div style="display:inline">
896 (
897 <span class="optional">optional</span>
898 <span class="enum" style="display: none; ">enumerated</span>
899 <span id="typeTemplate">
900 <span style="display: none; ">
901 <a> Type</a>
902 </span>
903 <span>
904 <span style="display: none; ">
905 array of <span><span></span></span>
906 </span>
907 <span>any</span>
908 <span style="display: none; "></span>
909 </span>
910 </span>
911 )
912 </div>
913
914 </em>
915 </dt>
916 <dd class="todo" style="display: none; ">
917 Undocumented.
918 </dd>
919 <dd>The old value of the item, if there was an old value.</dd>
920 <dd style="display: none; ">
921 This parameter was added in version
922 <b><span></span></b>.
923 You must omit this parameter in earlier versions,
924 and you may omit it in any version. If you require this
925 parameter, the manifest key
926 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
927 can ensure that your extension won't be run in an earlier browser ve rsion.
928 </dd>
929
930 <!-- OBJECT PROPERTIES -->
931 <dd style="display: none; ">
932 <dl>
933 <div>
934 <div>
935 </div>
936 </div>
937 </dl>
938 </dd>
939
940 <!-- OBJECT METHODS -->
941 <dd style="display: none; ">
942 <div></div>
943 </dd>
944
945 <!-- OBJECT EVENT FIELDS -->
946 <dd style="display: none; ">
947 <div></div>
948 </dd>
949
950 <!-- FUNCTION PARAMETERS -->
951 <dd style="display: none; ">
952 <div></div>
953 </dd>
954
955 </div>
956 </div><div>
957 <div>
958 <dt>
959 <var>newValue</var>
960 <em>
961
962 <!-- TYPE -->
963 <div style="display:inline">
964 (
965 <span class="optional">optional</span>
966 <span class="enum" style="display: none; ">enumerated</span>
967 <span id="typeTemplate">
968 <span style="display: none; ">
969 <a> Type</a>
970 </span>
971 <span>
972 <span style="display: none; ">
973 array of <span><span></span></span>
974 </span>
975 <span>any</span>
976 <span style="display: none; "></span>
977 </span>
978 </span>
979 )
980 </div>
981
982 </em>
983 </dt>
984 <dd class="todo" style="display: none; ">
985 Undocumented.
986 </dd>
987 <dd>The new value of the item, if there is a new value.</dd>
988 <dd style="display: none; ">
989 This parameter was added in version
990 <b><span></span></b>.
991 You must omit this parameter in earlier versions,
992 and you may omit it in any version. If you require this
993 parameter, the manifest key
994 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
995 can ensure that your extension won't be run in an earlier browser ve rsion.
996 </dd>
997
998 <!-- OBJECT PROPERTIES -->
999 <dd style="display: none; ">
1000 <dl>
1001 <div>
1002 <div>
1003 </div>
1004 </div>
1005 </dl>
1006 </dd>
1007
1008 <!-- OBJECT METHODS -->
1009 <dd style="display: none; ">
1010 <div></div>
1011 </dd>
1012
1013 <!-- OBJECT EVENT FIELDS -->
1014 <dd style="display: none; ">
1015 <div></div>
1016 </dd>
1017
1018 <!-- FUNCTION PARAMETERS -->
1019 <dd style="display: none; ">
1020 <div></div>
1021 </dd>
1022
1023 </div>
1024 </div>
1025 </dl>
1026 </dd>
1027
1028 <!-- OBJECT METHODS -->
1029 <dd style="display: none; ">
1030 <div></div>
1031 </dd>
1032
1033 <!-- OBJECT EVENT FIELDS -->
1034 <dd style="display: none; ">
1035 <div></div>
1036 </dd>
1037
1038 <!-- FUNCTION PARAMETERS -->
1039 <dd style="display: none; ">
1040 <div></div>
1041 </dd>
1042
1043 </div>
1044
1045 </div><div class="apiItem">
1046 <a name="type-StorageNamespace"></a>
1047 <h4>StorageNamespace</h4>
1048
1049 <div>
1050 <dt>
1051 <var style="display: none; ">paramName</var>
1052 <em>
1053
1054 <!-- TYPE -->
1055 <div style="display:inline">
1056 (
1057 <span class="optional" style="display: none; ">optional</spa n>
1058 <span class="enum" style="display: none; ">enumerated</span>
1059 <span id="typeTemplate">
1060 <span style="display: none; ">
1061 <a> Type</a>
1062 </span>
1063 <span>
1064 <span style="display: none; ">
1065 array of <span><span></span></span>
1066 </span>
1067 <span>object</span>
1068 <span style="display: none; "></span>
1069 </span>
1070 </span>
1071 )
1072 </div>
1073
1074 </em>
1075 </dt>
1076 <dd class="todo">
1077 Undocumented.
1078 </dd>
1079 <dd style="display: none; ">
1080 Description of this parameter from the json schema.
1081 </dd>
1082 <dd style="display: none; ">
1083 This parameter was added in version
1084 <b><span></span></b>.
1085 You must omit this parameter in earlier versions,
1086 and you may omit it in any version. If you require this
1087 parameter, the manifest key
1088 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1089 can ensure that your extension won't be run in an earlier browser ve rsion.
1090 </dd>
1091
1092 <!-- OBJECT PROPERTIES -->
1093 <dd style="display: none; ">
1094 <dl>
1095 <div>
1096 <div>
1097 </div>
1098 </div>
1099 </dl>
1100 </dd>
1101
1102 <!-- OBJECT METHODS -->
1103 <dd>
1104 <div class="apiGroup" style="">
1105 <a name="global-StorageNamespace-methods"></a>
1106 <h3>Methods of StorageNamespace</h3>
1107
1108 <!-- iterates over all functions -->
1109 <div class="apiItem">
1110 <a name="method-StorageNamespace-clear"></a> <!-- method-anchor -- >
1111 <h4>clear</h4>
1112
1113 <div class="summary"><span style="display: none; ">void</span>
1114 <!-- Note: intentionally longer 80 columns -->
1115 <span>storageNamespace.clear</span>(<span class="optional"><sp an style="display: none; ">, </span><span>function</span>
1116 <var><span>callback</span></var></span>)</div>
1117
1118 <div class="description">
1119 <p class="todo" style="display: none; ">Undocumented.</p>
1120 <p>Removes all items from storage.</p>
1121
1122 <!-- PARAMETERS -->
1123 <h4>Parameters</h4>
1124 <dl>
1125 <div>
1126 <div>
1127 <dt>
1128 <var>callback</var>
1129 <em>
1130
1131 <!-- TYPE -->
1132 <div style="display:inline">
1133 (
1134 <span class="optional">optional</span>
1135 <span class="enum" style="display: none; ">enumerated</span>
1136 <span id="typeTemplate">
1137 <span style="display: none; ">
1138 <a> Type</a>
1139 </span>
1140 <span>
1141 <span style="display: none; ">
1142 array of <span><span></span></span>
1143 </span>
1144 <span>function</span>
1145 <span style="display: none; "></span>
1146 </span>
1147 </span>
1148 )
1149 </div>
1150
1151 </em>
1152 </dt>
1153 <dd class="todo" style="display: none; ">
1154 Undocumented.
1155 </dd>
1156 <dd>Callback on success, or on failure (in which case lastError will b e set).</dd>
1157 <dd style="display: none; ">
1158 This parameter was added in version
1159 <b><span></span></b>.
1160 You must omit this parameter in earlier versions,
1161 and you may omit it in any version. If you require this
1162 parameter, the manifest key
1163 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1164 can ensure that your extension won't be run in an earlier browser ve rsion.
1165 </dd>
1166
1167 <!-- OBJECT PROPERTIES -->
1168 <dd style="display: none; ">
1169 <dl>
1170 <div>
1171 <div>
1172 </div>
1173 </div>
1174 </dl>
1175 </dd>
1176
1177 <!-- OBJECT METHODS -->
1178 <dd style="display: none; ">
1179 <div></div>
1180 </dd>
1181
1182 <!-- OBJECT EVENT FIELDS -->
1183 <dd style="display: none; ">
1184 <div></div>
1185 </dd>
1186
1187 <!-- FUNCTION PARAMETERS -->
1188 <dd style="display: none; ">
1189 <div></div>
1190 </dd>
1191
1192 </div>
1193 </div>
1194 </dl>
1195
1196 <!-- RETURNS -->
1197 <h4 style="display: none; ">Returns</h4>
1198 <dl>
1199 <div style="display: none; ">
1200 <div>
1201 </div>
1202 </div>
1203 </dl>
1204
1205 <!-- CALLBACK -->
1206 <div>
1207 <div>
1208 <h4>Callback function</h4>
1209 <p style="display: none; ">
1210 The callback <em>parameter</em> should specify a function
1211 that looks like this:
1212 </p>
1213 <p>
1214 If you specify the <em>callback</em> parameter, it should
1215 specify a function that looks like this:
1216 </p>
1217
1218 <!-- Note: intentionally longer 80 columns -->
1219 <pre>function(<span></span>) <span class="subdued">{...}</span >;</pre>
1220 <dl>
1221 <div style="display: none; ">
1222 <div>
1223 </div>
1224 </div>
1225 </dl>
1226 </div>
1227 </div>
1228
1229 <!-- MIN_VERSION -->
1230 <p style="display: none; ">
1231 This function was added in version <b><span></span></b>.
1232 If you require this function, the manifest key
1233 <a href="manifest.html#minimum_chrome_version">minimum_chrome_ version</a>
1234 can ensure that your extension won't be run in an earlier brow ser version.
1235 </p>
1236 </div> <!-- /description -->
1237
1238 </div><div class="apiItem">
1239 <a name="method-StorageNamespace-get"></a> <!-- method-anchor -->
1240 <h4>get</h4>
1241
1242 <div class="summary"><span style="display: none; ">void</span>
1243 <!-- Note: intentionally longer 80 columns -->
1244 <span>storageNamespace.get</span>(<span class="optional"><span style="display: none; ">, </span><span>string or array of string or object</spa n>
1245 <var><span>keys</span></var></span><span class="null"><spa n>, </span><span>function</span>
1246 <var><span>callback</span></var></span>)</div>
1247
1248 <div class="description">
1249 <p class="todo" style="display: none; ">Undocumented.</p>
1250 <p>Gets one or more items from storage.</p>
1251
1252 <!-- PARAMETERS -->
1253 <h4>Parameters</h4>
1254 <dl>
1255 <div>
1256 <div>
1257 <dt>
1258 <var>keys</var>
1259 <em>
1260
1261 <!-- TYPE -->
1262 <div style="display:inline">
1263 (
1264 <span class="optional">optional</span>
1265 <span class="enum" style="display: none; ">enumerated</span>
1266 <span id="typeTemplate">
1267 <span style="display: none; ">
1268 <a> Type</a>
1269 </span>
1270 <span>
1271 <span style="display: none; ">
1272 array of <span><span></span></span>
1273 </span>
1274 <span>string or array of string or object</span>
1275 <span style="display: none; "></span>
1276 </span>
1277 </span>
1278 )
1279 </div>
1280
1281 </em>
1282 </dt>
1283 <dd class="todo" style="display: none; ">
1284 Undocumented.
1285 </dd>
1286 <dd>A single key to get, list of keys to get, or a dictionary specifyi ng default values (see description of the object). An empty list or object will return an empty result object. Pass in null or undefined to get the entire con tents of storage; this should only be used for debugging.</dd>
1287 <dd style="display: none; ">
1288 This parameter was added in version
1289 <b><span></span></b>.
1290 You must omit this parameter in earlier versions,
1291 and you may omit it in any version. If you require this
1292 parameter, the manifest key
1293 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1294 can ensure that your extension won't be run in an earlier browser ve rsion.
1295 </dd>
1296
1297 <!-- OBJECT PROPERTIES -->
1298 <dd style="display: none; ">
1299 <dl>
1300 <div>
1301 <div>
1302 </div>
1303 </div>
1304 </dl>
1305 </dd>
1306
1307 <!-- OBJECT METHODS -->
1308 <dd style="display: none; ">
1309 <div></div>
1310 </dd>
1311
1312 <!-- OBJECT EVENT FIELDS -->
1313 <dd style="display: none; ">
1314 <div></div>
1315 </dd>
1316
1317 <!-- FUNCTION PARAMETERS -->
1318 <dd style="display: none; ">
1319 <div></div>
1320 </dd>
1321
1322 </div>
1323 </div><div>
1324 <div>
1325 <dt>
1326 <var>callback</var>
1327 <em>
1328
1329 <!-- TYPE -->
1330 <div style="display:inline">
1331 (
1332 <span class="optional" style="display: none; ">optional</spa n>
1333 <span class="enum" style="display: none; ">enumerated</span>
1334 <span id="typeTemplate">
1335 <span style="display: none; ">
1336 <a> Type</a>
1337 </span>
1338 <span>
1339 <span style="display: none; ">
1340 array of <span><span></span></span>
1341 </span>
1342 <span>function</span>
1343 <span style="display: none; "></span>
1344 </span>
1345 </span>
1346 )
1347 </div>
1348
1349 </em>
1350 </dt>
1351 <dd class="todo" style="display: none; ">
1352 Undocumented.
1353 </dd>
1354 <dd>Callback with storage items, or on failure (in which case lastErro r will be set).</dd>
1355 <dd style="display: none; ">
1356 This parameter was added in version
1357 <b><span></span></b>.
1358 You must omit this parameter in earlier versions,
1359 and you may omit it in any version. If you require this
1360 parameter, the manifest key
1361 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1362 can ensure that your extension won't be run in an earlier browser ve rsion.
1363 </dd>
1364
1365 <!-- OBJECT PROPERTIES -->
1366 <dd style="display: none; ">
1367 <dl>
1368 <div>
1369 <div>
1370 </div>
1371 </div>
1372 </dl>
1373 </dd>
1374
1375 <!-- OBJECT METHODS -->
1376 <dd style="display: none; ">
1377 <div></div>
1378 </dd>
1379
1380 <!-- OBJECT EVENT FIELDS -->
1381 <dd style="display: none; ">
1382 <div></div>
1383 </dd>
1384
1385 <!-- FUNCTION PARAMETERS -->
1386 <dd style="display: none; ">
1387 <div></div>
1388 </dd>
1389
1390 </div>
1391 </div>
1392 </dl>
1393
1394 <!-- RETURNS -->
1395 <h4 style="display: none; ">Returns</h4>
1396 <dl>
1397 <div style="display: none; ">
1398 <div>
1399 </div>
1400 </div>
1401 </dl>
1402
1403 <!-- CALLBACK -->
1404 <div>
1405 <div>
1406 <h4>Callback function</h4>
1407 <p>
1408 The callback <em>parameter</em> should specify a function
1409 that looks like this:
1410 </p>
1411 <p style="display: none; ">
1412 If you specify the <em>callback</em> parameter, it should
1413 specify a function that looks like this:
1414 </p>
1415
1416 <!-- Note: intentionally longer 80 columns -->
1417 <pre>function(<span>object items</span>) <span class="subdued" >{...}</span>;</pre>
1418 <dl>
1419 <div>
1420 <div>
1421 <dt>
1422 <var>items</var>
1423 <em>
1424
1425 <!-- TYPE -->
1426 <div style="display:inline">
1427 (
1428 <span class="optional" style="display: none; ">optional</spa n>
1429 <span class="enum" style="display: none; ">enumerated</span>
1430 <span id="typeTemplate">
1431 <span style="display: none; ">
1432 <a> Type</a>
1433 </span>
1434 <span>
1435 <span style="display: none; ">
1436 array of <span><span></span></span>
1437 </span>
1438 <span>object</span>
1439 <span style="display: none; "></span>
1440 </span>
1441 </span>
1442 )
1443 </div>
1444
1445 </em>
1446 </dt>
1447 <dd class="todo" style="display: none; ">
1448 Undocumented.
1449 </dd>
1450 <dd>Object with items in their key-value mappings.</dd>
1451 <dd style="display: none; ">
1452 This parameter was added in version
1453 <b><span></span></b>.
1454 You must omit this parameter in earlier versions,
1455 and you may omit it in any version. If you require this
1456 parameter, the manifest key
1457 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1458 can ensure that your extension won't be run in an earlier browser ve rsion.
1459 </dd>
1460
1461 <!-- OBJECT PROPERTIES -->
1462 <dd>
1463 <dl>
1464 <div style="display: none; ">
1465 <div>
1466 </div>
1467 </div>
1468 </dl>
1469 </dd>
1470
1471 <!-- OBJECT METHODS -->
1472 <dd style="display: none; ">
1473 <div></div>
1474 </dd>
1475
1476 <!-- OBJECT EVENT FIELDS -->
1477 <dd style="display: none; ">
1478 <div></div>
1479 </dd>
1480
1481 <!-- FUNCTION PARAMETERS -->
1482 <dd style="display: none; ">
1483 <div></div>
1484 </dd>
1485
1486 </div>
1487 </div>
1488 </dl>
1489 </div>
1490 </div>
1491
1492 <!-- MIN_VERSION -->
1493 <p style="display: none; ">
1494 This function was added in version <b><span></span></b>.
1495 If you require this function, the manifest key
1496 <a href="manifest.html#minimum_chrome_version">minimum_chrome_ version</a>
1497 can ensure that your extension won't be run in an earlier brow ser version.
1498 </p>
1499 </div> <!-- /description -->
1500
1501 </div><div class="apiItem">
1502 <a name="method-StorageNamespace-remove"></a> <!-- method-anchor - ->
1503 <h4>remove</h4>
1504
1505 <div class="summary"><span style="display: none; ">void</span>
1506 <!-- Note: intentionally longer 80 columns -->
1507 <span>storageNamespace.remove</span>(<span class="null"><span style="display: none; ">, </span><span>string or array of string</span>
1508 <var><span>keys</span></var></span><span class="optional"> <span>, </span><span>function</span>
1509 <var><span>callback</span></var></span>)</div>
1510
1511 <div class="description">
1512 <p class="todo" style="display: none; ">Undocumented.</p>
1513 <p>Removes one or more items from storage.</p>
1514
1515 <!-- PARAMETERS -->
1516 <h4>Parameters</h4>
1517 <dl>
1518 <div>
1519 <div>
1520 <dt>
1521 <var>keys</var>
1522 <em>
1523
1524 <!-- TYPE -->
1525 <div style="display:inline">
1526 (
1527 <span class="optional" style="display: none; ">optional</spa n>
1528 <span class="enum" style="display: none; ">enumerated</span>
1529 <span id="typeTemplate">
1530 <span style="display: none; ">
1531 <a> Type</a>
1532 </span>
1533 <span>
1534 <span style="display: none; ">
1535 array of <span><span></span></span>
1536 </span>
1537 <span>string or array of string</span>
1538 <span style="display: none; "></span>
1539 </span>
1540 </span>
1541 )
1542 </div>
1543
1544 </em>
1545 </dt>
1546 <dd class="todo" style="display: none; ">
1547 Undocumented.
1548 </dd>
1549 <dd>A single key or a list of keys for items to remove.</dd>
1550 <dd style="display: none; ">
1551 This parameter was added in version
1552 <b><span></span></b>.
1553 You must omit this parameter in earlier versions,
1554 and you may omit it in any version. If you require this
1555 parameter, the manifest key
1556 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1557 can ensure that your extension won't be run in an earlier browser ve rsion.
1558 </dd>
1559
1560 <!-- OBJECT PROPERTIES -->
1561 <dd style="display: none; ">
1562 <dl>
1563 <div>
1564 <div>
1565 </div>
1566 </div>
1567 </dl>
1568 </dd>
1569
1570 <!-- OBJECT METHODS -->
1571 <dd style="display: none; ">
1572 <div></div>
1573 </dd>
1574
1575 <!-- OBJECT EVENT FIELDS -->
1576 <dd style="display: none; ">
1577 <div></div>
1578 </dd>
1579
1580 <!-- FUNCTION PARAMETERS -->
1581 <dd style="display: none; ">
1582 <div></div>
1583 </dd>
1584
1585 </div>
1586 </div><div>
1587 <div>
1588 <dt>
1589 <var>callback</var>
1590 <em>
1591
1592 <!-- TYPE -->
1593 <div style="display:inline">
1594 (
1595 <span class="optional">optional</span>
1596 <span class="enum" style="display: none; ">enumerated</span>
1597 <span id="typeTemplate">
1598 <span style="display: none; ">
1599 <a> Type</a>
1600 </span>
1601 <span>
1602 <span style="display: none; ">
1603 array of <span><span></span></span>
1604 </span>
1605 <span>function</span>
1606 <span style="display: none; "></span>
1607 </span>
1608 </span>
1609 )
1610 </div>
1611
1612 </em>
1613 </dt>
1614 <dd class="todo" style="display: none; ">
1615 Undocumented.
1616 </dd>
1617 <dd>Callback on success, or on failure (in which case lastError will b e set).</dd>
1618 <dd style="display: none; ">
1619 This parameter was added in version
1620 <b><span></span></b>.
1621 You must omit this parameter in earlier versions,
1622 and you may omit it in any version. If you require this
1623 parameter, the manifest key
1624 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1625 can ensure that your extension won't be run in an earlier browser ve rsion.
1626 </dd>
1627
1628 <!-- OBJECT PROPERTIES -->
1629 <dd style="display: none; ">
1630 <dl>
1631 <div>
1632 <div>
1633 </div>
1634 </div>
1635 </dl>
1636 </dd>
1637
1638 <!-- OBJECT METHODS -->
1639 <dd style="display: none; ">
1640 <div></div>
1641 </dd>
1642
1643 <!-- OBJECT EVENT FIELDS -->
1644 <dd style="display: none; ">
1645 <div></div>
1646 </dd>
1647
1648 <!-- FUNCTION PARAMETERS -->
1649 <dd style="display: none; ">
1650 <div></div>
1651 </dd>
1652
1653 </div>
1654 </div>
1655 </dl>
1656
1657 <!-- RETURNS -->
1658 <h4 style="display: none; ">Returns</h4>
1659 <dl>
1660 <div style="display: none; ">
1661 <div>
1662 </div>
1663 </div>
1664 </dl>
1665
1666 <!-- CALLBACK -->
1667 <div>
1668 <div>
1669 <h4>Callback function</h4>
1670 <p style="display: none; ">
1671 The callback <em>parameter</em> should specify a function
1672 that looks like this:
1673 </p>
1674 <p>
1675 If you specify the <em>callback</em> parameter, it should
1676 specify a function that looks like this:
1677 </p>
1678
1679 <!-- Note: intentionally longer 80 columns -->
1680 <pre>function(<span></span>) <span class="subdued">{...}</span >;</pre>
1681 <dl>
1682 <div style="display: none; ">
1683 <div>
1684 </div>
1685 </div>
1686 </dl>
1687 </div>
1688 </div>
1689
1690 <!-- MIN_VERSION -->
1691 <p style="display: none; ">
1692 This function was added in version <b><span></span></b>.
1693 If you require this function, the manifest key
1694 <a href="manifest.html#minimum_chrome_version">minimum_chrome_ version</a>
1695 can ensure that your extension won't be run in an earlier brow ser version.
1696 </p>
1697 </div> <!-- /description -->
1698
1699 </div><div class="apiItem">
1700 <a name="method-StorageNamespace-set"></a> <!-- method-anchor -->
1701 <h4>set</h4>
1702
1703 <div class="summary"><span style="display: none; ">void</span>
1704 <!-- Note: intentionally longer 80 columns -->
1705 <span>storageNamespace.set</span>(<span class="null"><span sty le="display: none; ">, </span><span>object</span>
1706 <var><span>items</span></var></span><span class="optional" ><span>, </span><span>function</span>
1707 <var><span>callback</span></var></span>)</div>
1708
1709 <div class="description">
1710 <p class="todo" style="display: none; ">Undocumented.</p>
1711 <p>Sets multiple items.</p>
1712
1713 <!-- PARAMETERS -->
1714 <h4>Parameters</h4>
1715 <dl>
1716 <div>
1717 <div>
1718 <dt>
1719 <var>items</var>
1720 <em>
1721
1722 <!-- TYPE -->
1723 <div style="display:inline">
1724 (
1725 <span class="optional" style="display: none; ">optional</spa n>
1726 <span class="enum" style="display: none; ">enumerated</span>
1727 <span id="typeTemplate">
1728 <span style="display: none; ">
1729 <a> Type</a>
1730 </span>
1731 <span>
1732 <span style="display: none; ">
1733 array of <span><span></span></span>
1734 </span>
1735 <span>object</span>
1736 <span style="display: none; "></span>
1737 </span>
1738 </span>
1739 )
1740 </div>
1741
1742 </em>
1743 </dt>
1744 <dd class="todo" style="display: none; ">
1745 Undocumented.
1746 </dd>
1747 <dd>Object specifying items to augment storage with. Values that canno t be serialized (functions, etc) will be ignored.</dd>
1748 <dd style="display: none; ">
1749 This parameter was added in version
1750 <b><span></span></b>.
1751 You must omit this parameter in earlier versions,
1752 and you may omit it in any version. If you require this
1753 parameter, the manifest key
1754 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1755 can ensure that your extension won't be run in an earlier browser ve rsion.
1756 </dd>
1757
1758 <!-- OBJECT PROPERTIES -->
1759 <dd>
1760 <dl>
1761 <div style="display: none; ">
1762 <div>
1763 </div>
1764 </div>
1765 </dl>
1766 </dd>
1767
1768 <!-- OBJECT METHODS -->
1769 <dd style="display: none; ">
1770 <div></div>
1771 </dd>
1772
1773 <!-- OBJECT EVENT FIELDS -->
1774 <dd style="display: none; ">
1775 <div></div>
1776 </dd>
1777
1778 <!-- FUNCTION PARAMETERS -->
1779 <dd style="display: none; ">
1780 <div></div>
1781 </dd>
1782
1783 </div>
1784 </div><div>
1785 <div>
1786 <dt>
1787 <var>callback</var>
1788 <em>
1789
1790 <!-- TYPE -->
1791 <div style="display:inline">
1792 (
1793 <span class="optional">optional</span>
1794 <span class="enum" style="display: none; ">enumerated</span>
1795 <span id="typeTemplate">
1796 <span style="display: none; ">
1797 <a> Type</a>
1798 </span>
1799 <span>
1800 <span style="display: none; ">
1801 array of <span><span></span></span>
1802 </span>
1803 <span>function</span>
1804 <span style="display: none; "></span>
1805 </span>
1806 </span>
1807 )
1808 </div>
1809
1810 </em>
1811 </dt>
1812 <dd class="todo" style="display: none; ">
1813 Undocumented.
1814 </dd>
1815 <dd>Callback on success, or on failure (in which case lastError will b e set).</dd>
1816 <dd style="display: none; ">
1817 This parameter was added in version
1818 <b><span></span></b>.
1819 You must omit this parameter in earlier versions,
1820 and you may omit it in any version. If you require this
1821 parameter, the manifest key
1822 <a href="manifest.html#minimum_chrome_version">minimum_chrome_versio n</a>
1823 can ensure that your extension won't be run in an earlier browser ve rsion.
1824 </dd>
1825
1826 <!-- OBJECT PROPERTIES -->
1827 <dd style="display: none; ">
1828 <dl>
1829 <div>
1830 <div>
1831 </div>
1832 </div>
1833 </dl>
1834 </dd>
1835
1836 <!-- OBJECT METHODS -->
1837 <dd style="display: none; ">
1838 <div></div>
1839 </dd>
1840
1841 <!-- OBJECT EVENT FIELDS -->
1842 <dd style="display: none; ">
1843 <div></div>
1844 </dd>
1845
1846 <!-- FUNCTION PARAMETERS -->
1847 <dd style="display: none; ">
1848 <div></div>
1849 </dd>
1850
1851 </div>
1852 </div>
1853 </dl>
1854
1855 <!-- RETURNS -->
1856 <h4 style="display: none; ">Returns</h4>
1857 <dl>
1858 <div style="display: none; ">
1859 <div>
1860 </div>
1861 </div>
1862 </dl>
1863
1864 <!-- CALLBACK -->
1865 <div>
1866 <div>
1867 <h4>Callback function</h4>
1868 <p style="display: none; ">
1869 The callback <em>parameter</em> should specify a function
1870 that looks like this:
1871 </p>
1872 <p>
1873 If you specify the <em>callback</em> parameter, it should
1874 specify a function that looks like this:
1875 </p>
1876
1877 <!-- Note: intentionally longer 80 columns -->
1878 <pre>function(<span></span>) <span class="subdued">{...}</span >;</pre>
1879 <dl>
1880 <div style="display: none; ">
1881 <div>
1882 </div>
1883 </div>
1884 </dl>
1885 </div>
1886 </div>
1887
1888 <!-- MIN_VERSION -->
1889 <p style="display: none; ">
1890 This function was added in version <b><span></span></b>.
1891 If you require this function, the manifest key
1892 <a href="manifest.html#minimum_chrome_version">minimum_chrome_ version</a>
1893 can ensure that your extension won't be run in an earlier brow ser version.
1894 </p>
1895 </div> <!-- /description -->
1896
1897 </div> <!-- /apiItem -->
1898
1899 </div>
1900 </dd>
1901
1902 <!-- OBJECT EVENT FIELDS -->
1903 <dd style="display: none; ">
1904 <div></div>
1905 </dd>
1906
1907 <!-- FUNCTION PARAMETERS -->
1908 <dd style="display: none; ">
1909 <div></div>
1910 </dd>
1911
1912 </div>
1913
1914 </div> <!-- /apiItem -->
1915
1916 </div> <!-- /apiGroup -->
1917
1918 </div> <!-- /apiPage -->
1919 </div> <!-- /gc-pagecontent -->
1920 </div> <!-- /g-section -->
1921 </div> <!-- /codesiteContent -->
1922 <div id="gc-footer" --="">
1923 <div class="text">
1924 <p>
1925 Except as otherwise <a href="http://code.google.com/policies.html#restrictions ">noted</a>,
1926 the content of this page is licensed under the <a rel="license" href="http://c reativecommons.org/licenses/by/3.0/">Creative Commons
1927 Attribution 3.0 License</a>, and code samples are licensed under the
1928 <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD Lic ense</a>.
1929 </p>
1930 <p>
1931 ©2011 Google
1932 </p>
1933
1934 <!-- begin analytics -->
1935 <script src="https://www.google-analytics.com/urchin.js" type="text/javascript"> </script>
1936 <script src="https://www.google-analytics.com/ga.js" type="text/javascript"></sc ript>
1937
1938 <script type="text/javascript">
1939 // chrome doc tracking
1940 try {
1941 var engdocs = _gat._getTracker("YT-10763712-2");
1942 engdocs._trackPageview();
1943 } catch(err) {}
1944
1945 // code.google.com site-wide tracking
1946 try {
1947 _uacct="UA-18071-1";
1948 _uanchor=1;
1949 _uff=0;
1950 urchinTracker();
1951 }
1952 catch(e) {/* urchinTracker not available. */}
1953 </script>
1954 <!-- end analytics -->
1955 </div>
1956 </div> <!-- /gc-footer -->
1957 </div> <!-- /gc-container -->
1958 </body></html>
OLDNEW

Powered by Google App Engine
This is Rietveld 408576698