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/jstemplate_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 <title>Tabs - 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_version</a> 71 can ensure that your extension won't be run in an earlier browser version. 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 </div> <!-- /SUBTEMPLATES --> 111 112 <a id="top"></a> 113 <div id="skipto"> 114 <a href="#gc-pagecontent">Skip to page content</a> 115 <a href="#gc-toc">Skip to main navigation</a> 116 </div> 117 <!-- API HEADER --> 118 <table id="header" width="100%" cellspacing="0" border="0"> 119 <tbody><tr> 120 <td valign="middle"><a href="http://code.google.com/"><img src="images/code_labs_logo.gif" height="43" width="161" alt="Google Code Labs" style="border:0; margin:0;"></a></td> 121 <td valign="middle" width="100%" style="padding-left:0.6em;"> 122 <form action="http://www.google.com/cse" id="cse" style="margin-top:0.5em"> 123 <div id="gsc-search-box"> 124 <input type="hidden" name="cx" value="002967670403910741006:61_cvzfqtno"> 125 <input type="hidden" name="ie" value="UTF-8"> 126 <input type="text" name="q" value="" size="55"> 127 <input class="gsc-search-button" type="submit" name="sa" value="Search"> 128 <br> 129 <span class="greytext">e.g. "page action" or "tabs"</span> 130 </div> 131 </form> 132 133 <script type="text/javascript" src="http://www.google.com/jsapi"></script> 134 <script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script> 135 <script type="text/javascript" src="http://www.google.com/coop/cse/t13n?form=cse&t13n_langs=en"></script> 136 <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse&lang=en"></script> 137 </td> 138 </tr> 139 </tbody></table> 140 141 <div id="codesiteContent" class=""> 142 143 <a id="gc-topnav-anchor"></a> 144 <div id="gc-topnav"> 145 <h1>Google Chrome Extensions (<a href="http://code.google.com/labs/">Labs</a>)</h1> 146 <ul id="home" class="gc-topnav-tabs"> 147 <li id="home_link"> 148 <a href="index.html" title="Google Chrome Extensions home page">Home</a> 149 </li> 150 <li id="docs_link"> 151 <a href="docs.html" title="Official Google Chrome Extensions documentation">Docs</a> 152 </li> 153 <li id="faq_link"> 154 <a href="faq.html" title="Answers to frequently asked questions about Google Chrome Extensions">FAQ</a> 155 </li> 156 <li id="samples_link"> 157 <a href="samples.html" title="Sample extensions (with source code)">Samples</a> 158 </li> 159 <li id="group_link"> 160 <a href="http://groups.google.com/a/chromium.org/group/chromium-extensions" title="Google Chrome Extensions developer forum">Group</a> 161 </li> 162 </ul> 163 </div> <!-- end gc-topnav --> 164 165 <div class="g-section g-tpl-170"> 166 <!-- SIDENAV --> 167 <div class="g-unit g-first" id="gc-toc"> 168 <ul> 169 <li><a href="getstarted.html">Getting Started</a></li> 170 <li><a href="overview.html">Overview</a></li> 171 <li><a href="whats_new.html">What's New?</a></li> 172 <li><h2><a href="devguide.html">Developer's Guide</a></h2> 173 <ul> 174 <li>Browser UI 175 <ul> 176 <li><a href="browserAction.html">Browser Actions</a></li> 177 <li><a href="contextMenus.html">Context Menus</a></li> 178 <li><a href="notifications.html">Desktop Notifications</a></li> 179 <li><a href="omnibox.html">Omnibox</a></li> 180 <li><a href="options.html">Options Pages</a></li> 181 <li><a href="override.html">Override Pages</a></li> 182 <li><a href="pageAction.html">Page Actions</a></li> 183 </ul> 184 </li> 185 <li>Browser Interaction 186 <ul> 187 <li><a href="bookmarks.html">Bookmarks</a></li> 188 <li><a href="cookies.html">Cookies</a></li> 189 <li><a href="events.html">Events</a></li> 190 <li><a href="history.html">History</a></li> 191 <li><a href="management.html">Management</a></li> 192 <li class="leftNavSelected">Tabs</li> 193 <li><a href="windows.html">Windows</a></li> 194 </ul> 195 </li> 196 <li>Implementation 197 <ul> 198 <li><a href="a11y.html">Accessibility</a></li> 199 <li><a href="background_pages.html">Background Pages</a></li> 200 <li><a href="content_scripts.html">Content Scripts</a></li> 201 <li><a href="xhr.html">Cross-Origin XHR</a></li> 202 <li><a href="idle.html">Idle</a></li> 203 <li><a href="i18n.html">Internationalization</a></li> 204 <li><a href="messaging.html">Message Passing</a></li> 205 <li><a href="npapi.html">NPAPI Plugins</a></li> 206 </ul> 207 </li> 208 <li>Finishing 209 <ul> 210 <li><a href="hosting.html">Hosting</a></li> 211 <li><a href="external_extensions.html">Other Deployment Options</a></li> 212 </ul> 213 </li> 214 </ul> 215 </li> 216 <li><h2><a href="apps.html">Packaged Apps</a></h2></li> 217 <li><h2><a href="tutorials.html">Tutorials</a></h2> 218 <ul> 219 <li><a href="tut_debugging.html">Debugging</a></li> 220 <li><a href="tut_analytics.html">Google Analytics</a></li> 221 <li><a href="tut_oauth.html">OAuth</a></li> 222 </ul> 223 </li> 224 <li><h2>Reference</h2> 225 <ul> 226 <li>Formats 227 <ul> 228 <li><a href="manifest.html">Manifest Files</a></li> 229 <li><a href="match_patterns.html">Match Patterns</a></li> 230 </ul> 231 </li> 232 <li><a href="permission_warnings.html">Permission Warnings</a></li> 233 <li><a href="api_index.html">chrome.* APIs</a></li> 234 <li><a href="api_other.html">Other APIs</a></li> 235 </ul> 236 </li> 237 <li><h2><a href="samples.html">Samples</a></h2></li> 238 <div class="line"> </div> 239 <li><h2>More</h2> 240 <ul> 241 <li><a href="http://code.google.com/chrome/webstore/docs/index.html">Chrome Web Store</a></li> 242 <li><a href="http://code.google.com/chrome/apps/docs/developers_guide.html">Hosted Apps</a></li> 243 <li><a href="themes.html">Themes</a></li> 244 </ul> 245 </li> 246 </ul> 247 </div> 248 <script> 249 initToggles(); 250 </script> 251 252 <div class="g-unit" id="gc-pagecontent"> 253 <div id="pageTitle"> 254 <h1 class="page_title">Tabs</h1> 255 </div> 256 <!-- TABLE OF CONTENTS --> 257 <div id="toc"> 258 <h2>Contents</h2> 259 <ol> 260 <li> 261 <a href="#manifest">Manifest</a> 262 <ol> 263 <li style="display: none; "> 264 <a>h3Name</a> 265 </li> 266 </ol> 267 </li><li> 268 <a href="#examples"> Examples </a> 269 <ol> 270 <li style="display: none; "> 271 <a>h3Name</a> 272 </li> 273 </ol> 274 </li> 275 <li> 276 <a href="#apiReference">API reference: chrome.tabs</a> 277 <ol> 278 <li style="display: none; "> 279 <a href="#properties">Properties</a> 280 <ol> 281 <li> 282 <a href="#property-anchor">propertyName</a> 283 </li> 284 </ol> 285 </li> 286 <li> 287 <a href="#global-methods">Methods</a> 288 <ol> 289 <li> 290 <a href="#method-captureVisibleTab">captureVisibleTab</a> 291 </li><li> 292 <a href="#method-connect">connect</a> 293 </li><li> 294 <a href="#method-create">create</a> 295 </li><li> 296 <a href="#method-detectLanguage">detectLanguage</a> 297 </li><li> 298 <a href="#method-executeScript">executeScript</a> 299 </li><li> 300 <a href="#method-get">get</a> 301 </li><li> 302 <a href="#method-getAllInWindow">getAllInWindow</a> 303 </li><li> 304 <a href="#method-getCurrent">getCurrent</a> 305 </li><li> 306 <a href="#method-getSelected">getSelected</a> 307 </li><li> 308 <a href="#method-insertCSS">insertCSS</a> 309 </li><li> 310 <a href="#method-move">move</a> 311 </li><li> 312 <a href="#method-remove">remove</a> 313 </li><li> 314 <a href="#method-sendRequest">sendRequest</a> 315 </li><li> 316 <a href="#method-update">update</a> 317 </li> 318 </ol> 319 </li> 320 <li> 321 <a href="#global-events">Events</a> 322 <ol> 323 <li> 324 <a href="#event-onAttached">onAttached</a> 325 </li><li> 326 <a href="#event-onCreated">onCreated</a> 327 </li><li> 328 <a href="#event-onDetached">onDetached</a> 329 </li><li> 330 <a href="#event-onMoved">onMoved</a> 331 </li><li> 332 <a href="#event-onRemoved">onRemoved</a> 333 </li><li> 334 <a href="#event-onSelectionChanged">onSelectionChanged</a> 335 </li><li> 336 <a href="#event-onUpdated">onUpdated</a> 337 </li> 338 </ol> 339 </li> 340 <li> 341 <a href="#types">Types</a> 342 <ol> 343 <li> 344 <a href="#type-Tab">Tab</a> 345 </li> 346 </ol> 347 </li> 348 </ol> 349 </li> 350 </ol> 351 </div> 352 <!-- /TABLE OF CONTENTS --> 353 354 <!-- Standard content lead-in for experimental API pages --> 355 <p id="classSummary" style="display: none; "> 356 For information on how to use experimental APIs, see the <a href="experimental.html">chrome.experimental.* APIs</a> page. 357 </p> 358 359 <!-- STATIC CONTENT PLACEHOLDER --> 360 <div id="static"><div id="pageData-name" class="pageData">Tabs</div> 361 362 <!-- BEGIN AUTHORED CONTENT --> 363 <p id="classSummary"> 364 Use the <code>chrome.tabs</code> module 365 to interact with the browser's tab system. 366 You can use this module to 367 create, modify, and rearrange tabs in the browser. 368 </p> 369 370 <img src="images/tabs.png" width="323" height="50" alt="Two tabs in a window"> 371 372 <h2 id="manifest">Manifest</h2> 373 <p> 374 Almost all <code>chrome.tabs</code> methods require you to 375 declare the "tabs" permission 376 in the <a href="manifest.html">extension manifest</a>. 377 For example: 378 </p> 379 380 <pre>{ 381 "name": "My extension", 382 ... 383 <b>"permissions": [ 384 "tabs" 385 ]</b>, 386 ... 387 }</pre> 388 389 <p> 390 The two methods that don't require the "tabs" permission are 391 <a href="#method-create"><code>create</code></a> and 392 <a href="#method-update"><code>update</code></a>. 393 </p> 394 395 396 <h2 id="examples"> Examples </h2> 397 398 <p> 399 You can find simple examples of using the tabs module in the 400 <a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/tabs/">examples/api/tabs</a> 401 directory. 402 For other examples and for help in viewing the source code, see 403 <a href="samples.html">Samples</a>. 404 </p> 405 406 <!-- END AUTHORED CONTENT --> 407 </div> 408 409 <!-- API PAGE --> 410 <div class="apiPage"> 411 <a name="apiReference"></a> 412 <h2>API reference: chrome.tabs</h2> 413 414 <!-- PROPERTIES --> 415 <div class="apiGroup" style="display: none; "> 416 <a name="properties"></a> 417 <h3 id="properties">Properties</h3> 418 419 <div> 420 <a></a> 421 <h4>getLastError</h4> 422 <div class="summary"> 423 <!-- Note: intentionally longer 80 columns --> 424 <span>chrome.extension</span><span>lastError</span> 425 </div> 426 <div> 427 </div> 428 </div> 429 430 </div> <!-- /apiGroup --> 431 432 <!-- METHODS --> 433 <div id="methodsTemplate" class="apiGroup"> 434 <a name="global-methods"></a> 435 <h3>Methods</h3> 436 437 <!-- iterates over all functions --> 438 <div class="apiItem"> 439 <a name="method-captureVisibleTab"></a> <!-- method-anchor --> 440 <h4>captureVisibleTab</h4> 441 442 <div class="summary"><span style="display: none; ">void</span> 443 <!-- Note: intentionally longer 80 columns --> 444 <span>chrome.tabs.captureVisibleTab</span>(<span class="optional"><span style="display: none; ">, </span><span>integer</span> 445 <var><span>windowId</span></var></span><span class="optional"><span>, </span><span>object</span> 446 <var><span>options</span></var></span><span class="null"><span>, </span><span>function</span> 447 <var><span>callback</span></var></span>)</div> 448 449 <div class="description"> 450 <p class="todo" style="display: none; ">Undocumented.</p> 451 <p>Captures the visible area of the currently selected tab in the specified window. You must have <a href="manifest.html#permissions">host permission</a> for the URL displayed by the tab.</p> 452 453 <!-- PARAMETERS --> 454 <h4>Parameters</h4> 455 <dl> 456 <div> 457 <div> 458 <dt> 459 <var>windowId</var> 460 <em> 461 462 <!-- TYPE --> 463 <div style="display:inline"> 464 ( 465 <span class="optional">optional</span> 466 <span class="enum" style="display: none; ">enumerated</span> 467 <span id="typeTemplate"> 468 <span style="display: none; "> 469 <a> Type</a> 470 </span> 471 <span> 472 <span style="display: none; "> 473 array of <span><span></span></span> 474 </span> 475 <span>integer</span> 476 <span style="display: none; "></span> 477 </span> 478 </span> 479 ) 480 </div> 481 482 </em> 483 </dt> 484 <dd class="todo" style="display: none; "> 485 Undocumented. 486 </dd> 487 <dd>The target window. Defaults to the <a href="windows.html#current-window">current window</a>.</dd> 488 <dd style="display: none; "> 489 This parameter was added in version 490 <b><span></span></b>. 491 You must omit this parameter in earlier versions, 492 and you may omit it in any version. If you require this 493 parameter, the manifest key 494 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 495 can ensure that your extension won't be run in an earlier browser version. 496 </dd> 497 498 <!-- OBJECT PROPERTIES --> 499 <dd style="display: none; "> 500 <dl> 501 <div> 502 <div> 503 </div> 504 </div> 505 </dl> 506 </dd> 507 508 <!-- OBJECT METHODS --> 509 <dd style="display: none; "> 510 <div></div> 511 </dd> 512 513 <!-- OBJECT EVENT FIELDS --> 514 <dd style="display: none; "> 515 <div></div> 516 </dd> 517 518 <!-- FUNCTION PARAMETERS --> 519 <dd style="display: none; "> 520 <div></div> 521 </dd> 522 523 </div> 524 </div><div> 525 <div> 526 <dt> 527 <var>options</var> 528 <em> 529 530 <!-- TYPE --> 531 <div style="display:inline"> 532 ( 533 <span class="optional">optional</span> 534 <span class="enum" style="display: none; ">enumerated</span> 535 <span id="typeTemplate"> 536 <span style="display: none; "> 537 <a> Type</a> 538 </span> 539 <span> 540 <span style="display: none; "> 541 array of <span><span></span></span> 542 </span> 543 <span>object</span> 544 <span style="display: none; "></span> 545 </span> 546 </span> 547 ) 548 </div> 549 550 </em> 551 </dt> 552 <dd class="todo" style="display: none; "> 553 Undocumented. 554 </dd> 555 <dd>Set parameters of image capture, such as the format of the resulting image.</dd> 556 <dd style="display: none; "> 557 This parameter was added in version 558 <b><span></span></b>. 559 You must omit this parameter in earlier versions, 560 and you may omit it in any version. If you require this 561 parameter, the manifest key 562 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 563 can ensure that your extension won't be run in an earlier browser version. 564 </dd> 565 566 <!-- OBJECT PROPERTIES --> 567 <dd> 568 <dl> 569 <div> 570 <div> 571 <dt> 572 <var>format</var> 573 <em> 574 575 <!-- TYPE --> 576 <div style="display:inline"> 577 ( 578 <span class="optional">optional</span> 579 <span class="enum">enumerated</span> 580 <span id="typeTemplate"> 581 <span style="display: none; "> 582 <a> Type</a> 583 </span> 584 <span> 585 <span style="display: none; "> 586 array of <span><span></span></span> 587 </span> 588 <span>string</span> 589 <span>["jpeg", "png"]</span> 590 </span> 591 </span> 592 ) 593 </div> 594 595 </em> 596 </dt> 597 <dd class="todo" style="display: none; "> 598 Undocumented. 599 </dd> 600 <dd>The format of the resulting image. Default is jpeg.</dd> 601 <dd style="display: none; "> 602 This parameter was added in version 603 <b><span></span></b>. 604 You must omit this parameter in earlier versions, 605 and you may omit it in any version. If you require this 606 parameter, the manifest key 607 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 608 can ensure that your extension won't be run in an earlier browser version. 609 </dd> 610 611 <!-- OBJECT PROPERTIES --> 612 <dd style="display: none; "> 613 <dl> 614 <div> 615 <div> 616 </div> 617 </div> 618 </dl> 619 </dd> 620 621 <!-- OBJECT METHODS --> 622 <dd style="display: none; "> 623 <div></div> 624 </dd> 625 626 <!-- OBJECT EVENT FIELDS --> 627 <dd style="display: none; "> 628 <div></div> 629 </dd> 630 631 <!-- FUNCTION PARAMETERS --> 632 <dd style="display: none; "> 633 <div></div> 634 </dd> 635 636 </div> 637 </div><div> 638 <div> 639 <dt> 640 <var>quality</var> 641 <em> 642 643 <!-- TYPE --> 644 <div style="display:inline"> 645 ( 646 <span class="optional">optional</span> 647 <span class="enum" style="display: none; ">enumerated</span> 648 <span id="typeTemplate"> 649 <span style="display: none; "> 650 <a> Type</a> 651 </span> 652 <span> 653 <span style="display: none; "> 654 array of <span><span></span></span> 655 </span> 656 <span>integer</span> 657 <span style="display: none; "></span> 658 </span> 659 </span> 660 ) 661 </div> 662 663 </em> 664 </dt> 665 <dd class="todo" style="display: none; "> 666 Undocumented. 667 </dd> 668 <dd>When format is 'jpeg', controls the quality of the resulting image. This value is ignored for PNG images. As quality is decreased, the resulting image will have more visual artifacts, and the number of bytes needed to store it will decrease.</dd> 669 <dd style="display: none; "> 670 This parameter was added in version 671 <b><span></span></b>. 672 You must omit this parameter in earlier versions, 673 and you may omit it in any version. If you require this 674 parameter, the manifest key 675 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 676 can ensure that your extension won't be run in an earlier browser version. 677 </dd> 678 679 <!-- OBJECT PROPERTIES --> 680 <dd style="display: none; "> 681 <dl> 682 <div> 683 <div> 684 </div> 685 </div> 686 </dl> 687 </dd> 688 689 <!-- OBJECT METHODS --> 690 <dd style="display: none; "> 691 <div></div> 692 </dd> 693 694 <!-- OBJECT EVENT FIELDS --> 695 <dd style="display: none; "> 696 <div></div> 697 </dd> 698 699 <!-- FUNCTION PARAMETERS --> 700 <dd style="display: none; "> 701 <div></div> 702 </dd> 703 704 </div> 705 </div> 706 </dl> 707 </dd> 708 709 <!-- OBJECT METHODS --> 710 <dd style="display: none; "> 711 <div></div> 712 </dd> 713 714 <!-- OBJECT EVENT FIELDS --> 715 <dd style="display: none; "> 716 <div></div> 717 </dd> 718 719 <!-- FUNCTION PARAMETERS --> 720 <dd style="display: none; "> 721 <div></div> 722 </dd> 723 724 </div> 725 </div><div> 726 <div> 727 <dt> 728 <var>callback</var> 729 <em> 730 731 <!-- TYPE --> 732 <div style="display:inline"> 733 ( 734 <span class="optional" style="display: none; ">optional</span> 735 <span class="enum" style="display: none; ">enumerated</span> 736 <span id="typeTemplate"> 737 <span style="display: none; "> 738 <a> Type</a> 739 </span> 740 <span> 741 <span style="display: none; "> 742 array of <span><span></span></span> 743 </span> 744 <span>function</span> 745 <span style="display: none; "></span> 746 </span> 747 </span> 748 ) 749 </div> 750 751 </em> 752 </dt> 753 <dd class="todo"> 754 Undocumented. 755 </dd> 756 <dd style="display: none; "> 757 Description of this parameter from the json schema. 758 </dd> 759 <dd style="display: none; "> 760 This parameter was added in version 761 <b><span></span></b>. 762 You must omit this parameter in earlier versions, 763 and you may omit it in any version. If you require this 764 parameter, the manifest key 765 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 766 can ensure that your extension won't be run in an earlier browser version. 767 </dd> 768 769 <!-- OBJECT PROPERTIES --> 770 <dd style="display: none; "> 771 <dl> 772 <div> 773 <div> 774 </div> 775 </div> 776 </dl> 777 </dd> 778 779 <!-- OBJECT METHODS --> 780 <dd style="display: none; "> 781 <div></div> 782 </dd> 783 784 <!-- OBJECT EVENT FIELDS --> 785 <dd style="display: none; "> 786 <div></div> 787 </dd> 788 789 <!-- FUNCTION PARAMETERS --> 790 <dd style="display: none; "> 791 <div></div> 792 </dd> 793 794 </div> 795 </div> 796 </dl> 797 798 <!-- RETURNS --> 799 <h4 style="display: none; ">Returns</h4> 800 <dl> 801 <div style="display: none; "> 802 <div> 803 </div> 804 </div> 805 </dl> 806 807 <!-- CALLBACK --> 808 <div> 809 <div> 810 <h4>Callback function</h4> 811 <p> 812 The callback <em>parameter</em> should specify a function 813 that looks like this: 814 </p> 815 <p style="display: none; "> 816 If you specify the <em>callback</em> parameter, it should 817 specify a function that looks like this: 818 </p> 819 820 <!-- Note: intentionally longer 80 columns --> 821 <pre>function(<span>string dataUrl</span>) <span class="subdued">{...}</span>;</pre> 822 <dl> 823 <div> 824 <div> 825 <dt> 826 <var>dataUrl</var> 827 <em> 828 829 <!-- TYPE --> 830 <div style="display:inline"> 831 ( 832 <span class="optional" style="display: none; ">optional</span> 833 <span class="enum" style="display: none; ">enumerated</span> 834 <span id="typeTemplate"> 835 <span style="display: none; "> 836 <a> Type</a> 837 </span> 838 <span> 839 <span style="display: none; "> 840 array of <span><span></span></span> 841 </span> 842 <span>string</span> 843 <span style="display: none; "></span> 844 </span> 845 </span> 846 ) 847 </div> 848 849 </em> 850 </dt> 851 <dd class="todo" style="display: none; "> 852 Undocumented. 853 </dd> 854 <dd>A data URL which encodes an image of the visible area of the captured tab. May be assigned to the 'src' property of an HTML Image element for display.</dd> 855 <dd style="display: none; "> 856 This parameter was added in version 857 <b><span></span></b>. 858 You must omit this parameter in earlier versions, 859 and you may omit it in any version. If you require this 860 parameter, the manifest key 861 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 862 can ensure that your extension won't be run in an earlier browser version. 863 </dd> 864 865 <!-- OBJECT PROPERTIES --> 866 <dd style="display: none; "> 867 <dl> 868 <div> 869 <div> 870 </div> 871 </div> 872 </dl> 873 </dd> 874 875 <!-- OBJECT METHODS --> 876 <dd style="display: none; "> 877 <div></div> 878 </dd> 879 880 <!-- OBJECT EVENT FIELDS --> 881 <dd style="display: none; "> 882 <div></div> 883 </dd> 884 885 <!-- FUNCTION PARAMETERS --> 886 <dd style="display: none; "> 887 <div></div> 888 </dd> 889 890 </div> 891 </div> 892 </dl> 893 </div> 894 </div> 895 896 <!-- MIN_VERSION --> 897 <p style="display: none; "> 898 This function was added in version <b><span></span></b>. 899 If you require this function, the manifest key 900 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 901 can ensure that your extension won't be run in an earlier browser version. 902 </p> 903 </div> <!-- /description --> 904 905 </div><div class="apiItem"> 906 <a name="method-connect"></a> <!-- method-anchor --> 907 <h4>connect</h4> 908 909 <div class="summary"><span>Port</span> 910 <!-- Note: intentionally longer 80 columns --> 911 <span>chrome.tabs.connect</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 912 <var><span>tabId</span></var></span><span class="optional"><span>, </span><span>object</span> 913 <var><span>connectInfo</span></var></span>)</div> 914 915 <div class="description"> 916 <p class="todo" style="display: none; ">Undocumented.</p> 917 <p>Connects to the content script(s) in the specified tab. The <a href="extension.html#event-onConnect">chrome.extension.onConnect</a> event is fired in each content script running in the specified tab for the current extension. For more details, see <a href="content_scripts.html#messaging">Content Script Messaging</a>.</p> 918 919 <!-- PARAMETERS --> 920 <h4>Parameters</h4> 921 <dl> 922 <div> 923 <div> 924 <dt> 925 <var>tabId</var> 926 <em> 927 928 <!-- TYPE --> 929 <div style="display:inline"> 930 ( 931 <span class="optional" style="display: none; ">optional</span> 932 <span class="enum" style="display: none; ">enumerated</span> 933 <span id="typeTemplate"> 934 <span style="display: none; "> 935 <a> Type</a> 936 </span> 937 <span> 938 <span style="display: none; "> 939 array of <span><span></span></span> 940 </span> 941 <span>integer</span> 942 <span style="display: none; "></span> 943 </span> 944 </span> 945 ) 946 </div> 947 948 </em> 949 </dt> 950 <dd class="todo"> 951 Undocumented. 952 </dd> 953 <dd style="display: none; "> 954 Description of this parameter from the json schema. 955 </dd> 956 <dd style="display: none; "> 957 This parameter was added in version 958 <b><span></span></b>. 959 You must omit this parameter in earlier versions, 960 and you may omit it in any version. If you require this 961 parameter, the manifest key 962 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 963 can ensure that your extension won't be run in an earlier browser version. 964 </dd> 965 966 <!-- OBJECT PROPERTIES --> 967 <dd style="display: none; "> 968 <dl> 969 <div> 970 <div> 971 </div> 972 </div> 973 </dl> 974 </dd> 975 976 <!-- OBJECT METHODS --> 977 <dd style="display: none; "> 978 <div></div> 979 </dd> 980 981 <!-- OBJECT EVENT FIELDS --> 982 <dd style="display: none; "> 983 <div></div> 984 </dd> 985 986 <!-- FUNCTION PARAMETERS --> 987 <dd style="display: none; "> 988 <div></div> 989 </dd> 990 991 </div> 992 </div><div> 993 <div> 994 <dt> 995 <var>connectInfo</var> 996 <em> 997 998 <!-- TYPE --> 999 <div style="display:inline"> 1000 ( 1001 <span class="optional">optional</span> 1002 <span class="enum" style="display: none; ">enumerated</span> 1003 <span id="typeTemplate"> 1004 <span style="display: none; "> 1005 <a> Type</a> 1006 </span> 1007 <span> 1008 <span style="display: none; "> 1009 array of <span><span></span></span> 1010 </span> 1011 <span>object</span> 1012 <span style="display: none; "></span> 1013 </span> 1014 </span> 1015 ) 1016 </div> 1017 1018 </em> 1019 </dt> 1020 <dd class="todo"> 1021 Undocumented. 1022 </dd> 1023 <dd style="display: none; "> 1024 Description of this parameter from the json schema. 1025 </dd> 1026 <dd style="display: none; "> 1027 This parameter was added in version 1028 <b><span></span></b>. 1029 You must omit this parameter in earlier versions, 1030 and you may omit it in any version. If you require this 1031 parameter, the manifest key 1032 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1033 can ensure that your extension won't be run in an earlier browser version. 1034 </dd> 1035 1036 <!-- OBJECT PROPERTIES --> 1037 <dd> 1038 <dl> 1039 <div> 1040 <div> 1041 <dt> 1042 <var>name</var> 1043 <em> 1044 1045 <!-- TYPE --> 1046 <div style="display:inline"> 1047 ( 1048 <span class="optional">optional</span> 1049 <span class="enum" style="display: none; ">enumerated</span> 1050 <span id="typeTemplate"> 1051 <span style="display: none; "> 1052 <a> Type</a> 1053 </span> 1054 <span> 1055 <span style="display: none; "> 1056 array of <span><span></span></span> 1057 </span> 1058 <span>string</span> 1059 <span style="display: none; "></span> 1060 </span> 1061 </span> 1062 ) 1063 </div> 1064 1065 </em> 1066 </dt> 1067 <dd class="todo" style="display: none; "> 1068 Undocumented. 1069 </dd> 1070 <dd>Will be passed into onConnect for content scripts that are listening for the connection event.</dd> 1071 <dd style="display: none; "> 1072 This parameter was added in version 1073 <b><span></span></b>. 1074 You must omit this parameter in earlier versions, 1075 and you may omit it in any version. If you require this 1076 parameter, the manifest key 1077 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1078 can ensure that your extension won't be run in an earlier browser version. 1079 </dd> 1080 1081 <!-- OBJECT PROPERTIES --> 1082 <dd style="display: none; "> 1083 <dl> 1084 <div> 1085 <div> 1086 </div> 1087 </div> 1088 </dl> 1089 </dd> 1090 1091 <!-- OBJECT METHODS --> 1092 <dd style="display: none; "> 1093 <div></div> 1094 </dd> 1095 1096 <!-- OBJECT EVENT FIELDS --> 1097 <dd style="display: none; "> 1098 <div></div> 1099 </dd> 1100 1101 <!-- FUNCTION PARAMETERS --> 1102 <dd style="display: none; "> 1103 <div></div> 1104 </dd> 1105 1106 </div> 1107 </div> 1108 </dl> 1109 </dd> 1110 1111 <!-- OBJECT METHODS --> 1112 <dd style="display: none; "> 1113 <div></div> 1114 </dd> 1115 1116 <!-- OBJECT EVENT FIELDS --> 1117 <dd style="display: none; "> 1118 <div></div> 1119 </dd> 1120 1121 <!-- FUNCTION PARAMETERS --> 1122 <dd style="display: none; "> 1123 <div></div> 1124 </dd> 1125 1126 </div> 1127 </div> 1128 </dl> 1129 1130 <!-- RETURNS --> 1131 <h4>Returns</h4> 1132 <dl> 1133 <div> 1134 <div> 1135 <dt> 1136 <var style="display: none; ">paramName</var> 1137 <em> 1138 1139 <!-- TYPE --> 1140 <div style="display:inline"> 1141 ( 1142 <span class="optional" style="display: none; ">optional</span> 1143 <span class="enum" style="display: none; ">enumerated</span> 1144 <span id="typeTemplate"> 1145 <span> 1146 <a href="extension.html#type-Port">Port</a> 1147 </span> 1148 <span style="display: none; "> 1149 <span> 1150 array of <span><span></span></span> 1151 </span> 1152 <span>paramType</span> 1153 <span></span> 1154 </span> 1155 </span> 1156 ) 1157 </div> 1158 1159 </em> 1160 </dt> 1161 <dd class="todo" style="display: none; "> 1162 Undocumented. 1163 </dd> 1164 <dd>A port that can be used to communicate with the content scripts running in the specified tab. The port's <a href="extension.html#type-Port">onDisconnect</a> event is fired if the tab closes or does not exist. </dd> 1165 <dd style="display: none; "> 1166 This parameter was added in version 1167 <b><span></span></b>. 1168 You must omit this parameter in earlier versions, 1169 and you may omit it in any version. If you require this 1170 parameter, the manifest key 1171 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1172 can ensure that your extension won't be run in an earlier browser version. 1173 </dd> 1174 1175 <!-- OBJECT PROPERTIES --> 1176 <dd style="display: none; "> 1177 <dl> 1178 <div> 1179 <div> 1180 </div> 1181 </div> 1182 </dl> 1183 </dd> 1184 1185 <!-- OBJECT METHODS --> 1186 <dd style="display: none; "> 1187 <div></div> 1188 </dd> 1189 1190 <!-- OBJECT EVENT FIELDS --> 1191 <dd style="display: none; "> 1192 <div></div> 1193 </dd> 1194 1195 <!-- FUNCTION PARAMETERS --> 1196 <dd style="display: none; "> 1197 <div></div> 1198 </dd> 1199 1200 </div> 1201 </div> 1202 </dl> 1203 1204 <!-- CALLBACK --> 1205 <div style="display: none; "> 1206 <div> 1207 <h4>Callback function</h4> 1208 <p> 1209 The callback <em>parameter</em> should specify a function 1210 that looks like this: 1211 </p> 1212 <p> 1213 If you specify the <em>callback</em> parameter, it should 1214 specify a function that looks like this: 1215 </p> 1216 1217 <!-- Note: intentionally longer 80 columns --> 1218 <pre>function(<span>Type param1, Type param2</span>) <span class="subdued">{...}</span>;</pre> 1219 <dl> 1220 <div> 1221 <div> 1222 </div> 1223 </div> 1224 </dl> 1225 </div> 1226 </div> 1227 1228 <!-- MIN_VERSION --> 1229 <p style="display: none; "> 1230 This function was added in version <b><span></span></b>. 1231 If you require this function, the manifest key 1232 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1233 can ensure that your extension won't be run in an earlier browser version. 1234 </p> 1235 </div> <!-- /description --> 1236 1237 </div><div class="apiItem"> 1238 <a name="method-create"></a> <!-- method-anchor --> 1239 <h4>create</h4> 1240 1241 <div class="summary"><span style="display: none; ">void</span> 1242 <!-- Note: intentionally longer 80 columns --> 1243 <span>chrome.tabs.create</span>(<span class="null"><span style="display: none; ">, </span><span>object</span> 1244 <var><span>createProperties</span></var></span><span class="optional"><span>, </span><span>function</span> 1245 <var><span>callback</span></var></span>)</div> 1246 1247 <div class="description"> 1248 <p class="todo" style="display: none; ">Undocumented.</p> 1249 <p>Creates a new tab. Note: This function can be used without requesting the 'tabs' permission in the manifest.</p> 1250 1251 <!-- PARAMETERS --> 1252 <h4>Parameters</h4> 1253 <dl> 1254 <div> 1255 <div> 1256 <dt> 1257 <var>createProperties</var> 1258 <em> 1259 1260 <!-- TYPE --> 1261 <div style="display:inline"> 1262 ( 1263 <span class="optional" style="display: none; ">optional</span> 1264 <span class="enum" style="display: none; ">enumerated</span> 1265 <span id="typeTemplate"> 1266 <span style="display: none; "> 1267 <a> Type</a> 1268 </span> 1269 <span> 1270 <span style="display: none; "> 1271 array of <span><span></span></span> 1272 </span> 1273 <span>object</span> 1274 <span style="display: none; "></span> 1275 </span> 1276 </span> 1277 ) 1278 </div> 1279 1280 </em> 1281 </dt> 1282 <dd class="todo"> 1283 Undocumented. 1284 </dd> 1285 <dd style="display: none; "> 1286 Description of this parameter from the json schema. 1287 </dd> 1288 <dd style="display: none; "> 1289 This parameter was added in version 1290 <b><span></span></b>. 1291 You must omit this parameter in earlier versions, 1292 and you may omit it in any version. If you require this 1293 parameter, the manifest key 1294 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1295 can ensure that your extension won't be run in an earlier browser version. 1296 </dd> 1297 1298 <!-- OBJECT PROPERTIES --> 1299 <dd> 1300 <dl> 1301 <div> 1302 <div> 1303 <dt> 1304 <var>windowId</var> 1305 <em> 1306 1307 <!-- TYPE --> 1308 <div style="display:inline"> 1309 ( 1310 <span class="optional">optional</span> 1311 <span class="enum" style="display: none; ">enumerated</span> 1312 <span id="typeTemplate"> 1313 <span style="display: none; "> 1314 <a> Type</a> 1315 </span> 1316 <span> 1317 <span style="display: none; "> 1318 array of <span><span></span></span> 1319 </span> 1320 <span>integer</span> 1321 <span style="display: none; "></span> 1322 </span> 1323 </span> 1324 ) 1325 </div> 1326 1327 </em> 1328 </dt> 1329 <dd class="todo" style="display: none; "> 1330 Undocumented. 1331 </dd> 1332 <dd>The window to create the new tab in. Defaults to the <a href="windows.html#current-window">current window</a>.</dd> 1333 <dd style="display: none; "> 1334 This parameter was added in version 1335 <b><span></span></b>. 1336 You must omit this parameter in earlier versions, 1337 and you may omit it in any version. If you require this 1338 parameter, the manifest key 1339 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1340 can ensure that your extension won't be run in an earlier browser version. 1341 </dd> 1342 1343 <!-- OBJECT PROPERTIES --> 1344 <dd style="display: none; "> 1345 <dl> 1346 <div> 1347 <div> 1348 </div> 1349 </div> 1350 </dl> 1351 </dd> 1352 1353 <!-- OBJECT METHODS --> 1354 <dd style="display: none; "> 1355 <div></div> 1356 </dd> 1357 1358 <!-- OBJECT EVENT FIELDS --> 1359 <dd style="display: none; "> 1360 <div></div> 1361 </dd> 1362 1363 <!-- FUNCTION PARAMETERS --> 1364 <dd style="display: none; "> 1365 <div></div> 1366 </dd> 1367 1368 </div> 1369 </div><div> 1370 <div> 1371 <dt> 1372 <var>index</var> 1373 <em> 1374 1375 <!-- TYPE --> 1376 <div style="display:inline"> 1377 ( 1378 <span class="optional">optional</span> 1379 <span class="enum" style="display: none; ">enumerated</span> 1380 <span id="typeTemplate"> 1381 <span style="display: none; "> 1382 <a> Type</a> 1383 </span> 1384 <span> 1385 <span style="display: none; "> 1386 array of <span><span></span></span> 1387 </span> 1388 <span>integer</span> 1389 <span style="display: none; "></span> 1390 </span> 1391 </span> 1392 ) 1393 </div> 1394 1395 </em> 1396 </dt> 1397 <dd class="todo" style="display: none; "> 1398 Undocumented. 1399 </dd> 1400 <dd>The position the tab should take in the window. The provided value will be clamped to between zero and the number of tabs in the window.</dd> 1401 <dd style="display: none; "> 1402 This parameter was added in version 1403 <b><span></span></b>. 1404 You must omit this parameter in earlier versions, 1405 and you may omit it in any version. If you require this 1406 parameter, the manifest key 1407 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1408 can ensure that your extension won't be run in an earlier browser version. 1409 </dd> 1410 1411 <!-- OBJECT PROPERTIES --> 1412 <dd style="display: none; "> 1413 <dl> 1414 <div> 1415 <div> 1416 </div> 1417 </div> 1418 </dl> 1419 </dd> 1420 1421 <!-- OBJECT METHODS --> 1422 <dd style="display: none; "> 1423 <div></div> 1424 </dd> 1425 1426 <!-- OBJECT EVENT FIELDS --> 1427 <dd style="display: none; "> 1428 <div></div> 1429 </dd> 1430 1431 <!-- FUNCTION PARAMETERS --> 1432 <dd style="display: none; "> 1433 <div></div> 1434 </dd> 1435 1436 </div> 1437 </div><div> 1438 <div> 1439 <dt> 1440 <var>url</var> 1441 <em> 1442 1443 <!-- TYPE --> 1444 <div style="display:inline"> 1445 ( 1446 <span class="optional">optional</span> 1447 <span class="enum" style="display: none; ">enumerated</span> 1448 <span id="typeTemplate"> 1449 <span style="display: none; "> 1450 <a> Type</a> 1451 </span> 1452 <span> 1453 <span style="display: none; "> 1454 array of <span><span></span></span> 1455 </span> 1456 <span>string</span> 1457 <span style="display: none; "></span> 1458 </span> 1459 </span> 1460 ) 1461 </div> 1462 1463 </em> 1464 </dt> 1465 <dd class="todo" style="display: none; "> 1466 Undocumented. 1467 </dd> 1468 <dd>The URL to navigate the tab to initially. Fully-qualified URLs must include a scheme (i.e. 'http://www.google.com', not 'www.google.com'). Relative URLs will be relative to the current page within the extension. Defaults to the New Tab Page.</dd> 1469 <dd style="display: none; "> 1470 This parameter was added in version 1471 <b><span></span></b>. 1472 You must omit this parameter in earlier versions, 1473 and you may omit it in any version. If you require this 1474 parameter, the manifest key 1475 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1476 can ensure that your extension won't be run in an earlier browser version. 1477 </dd> 1478 1479 <!-- OBJECT PROPERTIES --> 1480 <dd style="display: none; "> 1481 <dl> 1482 <div> 1483 <div> 1484 </div> 1485 </div> 1486 </dl> 1487 </dd> 1488 1489 <!-- OBJECT METHODS --> 1490 <dd style="display: none; "> 1491 <div></div> 1492 </dd> 1493 1494 <!-- OBJECT EVENT FIELDS --> 1495 <dd style="display: none; "> 1496 <div></div> 1497 </dd> 1498 1499 <!-- FUNCTION PARAMETERS --> 1500 <dd style="display: none; "> 1501 <div></div> 1502 </dd> 1503 1504 </div> 1505 </div><div> 1506 <div> 1507 <dt> 1508 <var>selected</var> 1509 <em> 1510 1511 <!-- TYPE --> 1512 <div style="display:inline"> 1513 ( 1514 <span class="optional">optional</span> 1515 <span class="enum" style="display: none; ">enumerated</span> 1516 <span id="typeTemplate"> 1517 <span style="display: none; "> 1518 <a> Type</a> 1519 </span> 1520 <span> 1521 <span style="display: none; "> 1522 array of <span><span></span></span> 1523 </span> 1524 <span>boolean</span> 1525 <span style="display: none; "></span> 1526 </span> 1527 </span> 1528 ) 1529 </div> 1530 1531 </em> 1532 </dt> 1533 <dd class="todo" style="display: none; "> 1534 Undocumented. 1535 </dd> 1536 <dd>Whether the tab should become the selected tab in the window. Defaults to <var>true</var></dd> 1537 <dd style="display: none; "> 1538 This parameter was added in version 1539 <b><span></span></b>. 1540 You must omit this parameter in earlier versions, 1541 and you may omit it in any version. If you require this 1542 parameter, the manifest key 1543 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1544 can ensure that your extension won't be run in an earlier browser version. 1545 </dd> 1546 1547 <!-- OBJECT PROPERTIES --> 1548 <dd style="display: none; "> 1549 <dl> 1550 <div> 1551 <div> 1552 </div> 1553 </div> 1554 </dl> 1555 </dd> 1556 1557 <!-- OBJECT METHODS --> 1558 <dd style="display: none; "> 1559 <div></div> 1560 </dd> 1561 1562 <!-- OBJECT EVENT FIELDS --> 1563 <dd style="display: none; "> 1564 <div></div> 1565 </dd> 1566 1567 <!-- FUNCTION PARAMETERS --> 1568 <dd style="display: none; "> 1569 <div></div> 1570 </dd> 1571 1572 </div> 1573 </div><div> 1574 <div> 1575 <dt> 1576 <var>pinned</var> 1577 <em> 1578 1579 <!-- TYPE --> 1580 <div style="display:inline"> 1581 ( 1582 <span class="optional">optional</span> 1583 <span class="enum" style="display: none; ">enumerated</span> 1584 <span id="typeTemplate"> 1585 <span style="display: none; "> 1586 <a> Type</a> 1587 </span> 1588 <span> 1589 <span style="display: none; "> 1590 array of <span><span></span></span> 1591 </span> 1592 <span>boolean</span> 1593 <span style="display: none; "></span> 1594 </span> 1595 </span> 1596 ) 1597 </div> 1598 1599 </em> 1600 </dt> 1601 <dd class="todo" style="display: none; "> 1602 Undocumented. 1603 </dd> 1604 <dd>Whether the tab should be pinned. Defaults to <var>false</var></dd> 1605 <dd style="display: none; "> 1606 This parameter was added in version 1607 <b><span></span></b>. 1608 You must omit this parameter in earlier versions, 1609 and you may omit it in any version. If you require this 1610 parameter, the manifest key 1611 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1612 can ensure that your extension won't be run in an earlier browser version. 1613 </dd> 1614 1615 <!-- OBJECT PROPERTIES --> 1616 <dd style="display: none; "> 1617 <dl> 1618 <div> 1619 <div> 1620 </div> 1621 </div> 1622 </dl> 1623 </dd> 1624 1625 <!-- OBJECT METHODS --> 1626 <dd style="display: none; "> 1627 <div></div> 1628 </dd> 1629 1630 <!-- OBJECT EVENT FIELDS --> 1631 <dd style="display: none; "> 1632 <div></div> 1633 </dd> 1634 1635 <!-- FUNCTION PARAMETERS --> 1636 <dd style="display: none; "> 1637 <div></div> 1638 </dd> 1639 1640 </div> 1641 </div> 1642 </dl> 1643 </dd> 1644 1645 <!-- OBJECT METHODS --> 1646 <dd style="display: none; "> 1647 <div></div> 1648 </dd> 1649 1650 <!-- OBJECT EVENT FIELDS --> 1651 <dd style="display: none; "> 1652 <div></div> 1653 </dd> 1654 1655 <!-- FUNCTION PARAMETERS --> 1656 <dd style="display: none; "> 1657 <div></div> 1658 </dd> 1659 1660 </div> 1661 </div><div> 1662 <div> 1663 <dt> 1664 <var>callback</var> 1665 <em> 1666 1667 <!-- TYPE --> 1668 <div style="display:inline"> 1669 ( 1670 <span class="optional">optional</span> 1671 <span class="enum" style="display: none; ">enumerated</span> 1672 <span id="typeTemplate"> 1673 <span style="display: none; "> 1674 <a> Type</a> 1675 </span> 1676 <span> 1677 <span style="display: none; "> 1678 array of <span><span></span></span> 1679 </span> 1680 <span>function</span> 1681 <span style="display: none; "></span> 1682 </span> 1683 </span> 1684 ) 1685 </div> 1686 1687 </em> 1688 </dt> 1689 <dd class="todo"> 1690 Undocumented. 1691 </dd> 1692 <dd style="display: none; "> 1693 Description of this parameter from the json schema. 1694 </dd> 1695 <dd style="display: none; "> 1696 This parameter was added in version 1697 <b><span></span></b>. 1698 You must omit this parameter in earlier versions, 1699 and you may omit it in any version. If you require this 1700 parameter, the manifest key 1701 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1702 can ensure that your extension won't be run in an earlier browser version. 1703 </dd> 1704 1705 <!-- OBJECT PROPERTIES --> 1706 <dd style="display: none; "> 1707 <dl> 1708 <div> 1709 <div> 1710 </div> 1711 </div> 1712 </dl> 1713 </dd> 1714 1715 <!-- OBJECT METHODS --> 1716 <dd style="display: none; "> 1717 <div></div> 1718 </dd> 1719 1720 <!-- OBJECT EVENT FIELDS --> 1721 <dd style="display: none; "> 1722 <div></div> 1723 </dd> 1724 1725 <!-- FUNCTION PARAMETERS --> 1726 <dd style="display: none; "> 1727 <div></div> 1728 </dd> 1729 1730 </div> 1731 </div> 1732 </dl> 1733 1734 <!-- RETURNS --> 1735 <h4 style="display: none; ">Returns</h4> 1736 <dl> 1737 <div style="display: none; "> 1738 <div> 1739 </div> 1740 </div> 1741 </dl> 1742 1743 <!-- CALLBACK --> 1744 <div> 1745 <div> 1746 <h4>Callback function</h4> 1747 <p style="display: none; "> 1748 The callback <em>parameter</em> should specify a function 1749 that looks like this: 1750 </p> 1751 <p> 1752 If you specify the <em>callback</em> parameter, it should 1753 specify a function that looks like this: 1754 </p> 1755 1756 <!-- Note: intentionally longer 80 columns --> 1757 <pre>function(<span>Tab tab</span>) <span class="subdued">{...}</span>;</pre> 1758 <dl> 1759 <div> 1760 <div> 1761 <dt> 1762 <var>tab</var> 1763 <em> 1764 1765 <!-- TYPE --> 1766 <div style="display:inline"> 1767 ( 1768 <span class="optional" style="display: none; ">optional</span> 1769 <span class="enum" style="display: none; ">enumerated</span> 1770 <span id="typeTemplate"> 1771 <span> 1772 <a href="tabs.html#type-Tab">Tab</a> 1773 </span> 1774 <span style="display: none; "> 1775 <span> 1776 array of <span><span></span></span> 1777 </span> 1778 <span>paramType</span> 1779 <span></span> 1780 </span> 1781 </span> 1782 ) 1783 </div> 1784 1785 </em> 1786 </dt> 1787 <dd class="todo" style="display: none; "> 1788 Undocumented. 1789 </dd> 1790 <dd>Details about the created tab. Will contain the ID of the new tab.</dd> 1791 <dd style="display: none; "> 1792 This parameter was added in version 1793 <b><span></span></b>. 1794 You must omit this parameter in earlier versions, 1795 and you may omit it in any version. If you require this 1796 parameter, the manifest key 1797 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1798 can ensure that your extension won't be run in an earlier browser version. 1799 </dd> 1800 1801 <!-- OBJECT PROPERTIES --> 1802 <dd style="display: none; "> 1803 <dl> 1804 <div> 1805 <div> 1806 </div> 1807 </div> 1808 </dl> 1809 </dd> 1810 1811 <!-- OBJECT METHODS --> 1812 <dd style="display: none; "> 1813 <div></div> 1814 </dd> 1815 1816 <!-- OBJECT EVENT FIELDS --> 1817 <dd style="display: none; "> 1818 <div></div> 1819 </dd> 1820 1821 <!-- FUNCTION PARAMETERS --> 1822 <dd style="display: none; "> 1823 <div></div> 1824 </dd> 1825 1826 </div> 1827 </div> 1828 </dl> 1829 </div> 1830 </div> 1831 1832 <!-- MIN_VERSION --> 1833 <p style="display: none; "> 1834 This function was added in version <b><span></span></b>. 1835 If you require this function, the manifest key 1836 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1837 can ensure that your extension won't be run in an earlier browser version. 1838 </p> 1839 </div> <!-- /description --> 1840 1841 </div><div class="apiItem"> 1842 <a name="method-detectLanguage"></a> <!-- method-anchor --> 1843 <h4>detectLanguage</h4> 1844 1845 <div class="summary"><span style="display: none; ">void</span> 1846 <!-- Note: intentionally longer 80 columns --> 1847 <span>chrome.tabs.detectLanguage</span>(<span class="optional"><span style="display: none; ">, </span><span>integer</span> 1848 <var><span>tabId</span></var></span><span class="null"><span>, </span><span>function</span> 1849 <var><span>callback</span></var></span>)</div> 1850 1851 <div class="description"> 1852 <p class="todo" style="display: none; ">Undocumented.</p> 1853 <p>Detects the primary language of the content in a tab.</p> 1854 1855 <!-- PARAMETERS --> 1856 <h4>Parameters</h4> 1857 <dl> 1858 <div> 1859 <div> 1860 <dt> 1861 <var>tabId</var> 1862 <em> 1863 1864 <!-- TYPE --> 1865 <div style="display:inline"> 1866 ( 1867 <span class="optional">optional</span> 1868 <span class="enum" style="display: none; ">enumerated</span> 1869 <span id="typeTemplate"> 1870 <span style="display: none; "> 1871 <a> Type</a> 1872 </span> 1873 <span> 1874 <span style="display: none; "> 1875 array of <span><span></span></span> 1876 </span> 1877 <span>integer</span> 1878 <span style="display: none; "></span> 1879 </span> 1880 </span> 1881 ) 1882 </div> 1883 1884 </em> 1885 </dt> 1886 <dd class="todo" style="display: none; "> 1887 Undocumented. 1888 </dd> 1889 <dd>Defaults to the selected tab of the <a href="windows.html#current-window">current window</a>.</dd> 1890 <dd style="display: none; "> 1891 This parameter was added in version 1892 <b><span></span></b>. 1893 You must omit this parameter in earlier versions, 1894 and you may omit it in any version. If you require this 1895 parameter, the manifest key 1896 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1897 can ensure that your extension won't be run in an earlier browser version. 1898 </dd> 1899 1900 <!-- OBJECT PROPERTIES --> 1901 <dd style="display: none; "> 1902 <dl> 1903 <div> 1904 <div> 1905 </div> 1906 </div> 1907 </dl> 1908 </dd> 1909 1910 <!-- OBJECT METHODS --> 1911 <dd style="display: none; "> 1912 <div></div> 1913 </dd> 1914 1915 <!-- OBJECT EVENT FIELDS --> 1916 <dd style="display: none; "> 1917 <div></div> 1918 </dd> 1919 1920 <!-- FUNCTION PARAMETERS --> 1921 <dd style="display: none; "> 1922 <div></div> 1923 </dd> 1924 1925 </div> 1926 </div><div> 1927 <div> 1928 <dt> 1929 <var>callback</var> 1930 <em> 1931 1932 <!-- TYPE --> 1933 <div style="display:inline"> 1934 ( 1935 <span class="optional" style="display: none; ">optional</span> 1936 <span class="enum" style="display: none; ">enumerated</span> 1937 <span id="typeTemplate"> 1938 <span style="display: none; "> 1939 <a> Type</a> 1940 </span> 1941 <span> 1942 <span style="display: none; "> 1943 array of <span><span></span></span> 1944 </span> 1945 <span>function</span> 1946 <span style="display: none; "></span> 1947 </span> 1948 </span> 1949 ) 1950 </div> 1951 1952 </em> 1953 </dt> 1954 <dd class="todo"> 1955 Undocumented. 1956 </dd> 1957 <dd style="display: none; "> 1958 Description of this parameter from the json schema. 1959 </dd> 1960 <dd style="display: none; "> 1961 This parameter was added in version 1962 <b><span></span></b>. 1963 You must omit this parameter in earlier versions, 1964 and you may omit it in any version. If you require this 1965 parameter, the manifest key 1966 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1967 can ensure that your extension won't be run in an earlier browser version. 1968 </dd> 1969 1970 <!-- OBJECT PROPERTIES --> 1971 <dd style="display: none; "> 1972 <dl> 1973 <div> 1974 <div> 1975 </div> 1976 </div> 1977 </dl> 1978 </dd> 1979 1980 <!-- OBJECT METHODS --> 1981 <dd style="display: none; "> 1982 <div></div> 1983 </dd> 1984 1985 <!-- OBJECT EVENT FIELDS --> 1986 <dd style="display: none; "> 1987 <div></div> 1988 </dd> 1989 1990 <!-- FUNCTION PARAMETERS --> 1991 <dd style="display: none; "> 1992 <div></div> 1993 </dd> 1994 1995 </div> 1996 </div> 1997 </dl> 1998 1999 <!-- RETURNS --> 2000 <h4 style="display: none; ">Returns</h4> 2001 <dl> 2002 <div style="display: none; "> 2003 <div> 2004 </div> 2005 </div> 2006 </dl> 2007 2008 <!-- CALLBACK --> 2009 <div> 2010 <div> 2011 <h4>Callback function</h4> 2012 <p> 2013 The callback <em>parameter</em> should specify a function 2014 that looks like this: 2015 </p> 2016 <p style="display: none; "> 2017 If you specify the <em>callback</em> parameter, it should 2018 specify a function that looks like this: 2019 </p> 2020 2021 <!-- Note: intentionally longer 80 columns --> 2022 <pre>function(<span>string language</span>) <span class="subdued">{...}</span>;</pre> 2023 <dl> 2024 <div> 2025 <div> 2026 <dt> 2027 <var>language</var> 2028 <em> 2029 2030 <!-- TYPE --> 2031 <div style="display:inline"> 2032 ( 2033 <span class="optional" style="display: none; ">optional</span> 2034 <span class="enum" style="display: none; ">enumerated</span> 2035 <span id="typeTemplate"> 2036 <span style="display: none; "> 2037 <a> Type</a> 2038 </span> 2039 <span> 2040 <span style="display: none; "> 2041 array of <span><span></span></span> 2042 </span> 2043 <span>string</span> 2044 <span style="display: none; "></span> 2045 </span> 2046 </span> 2047 ) 2048 </div> 2049 2050 </em> 2051 </dt> 2052 <dd class="todo" style="display: none; "> 2053 Undocumented. 2054 </dd> 2055 <dd>An ISO language code such as <code>en</code> or <code>fr</code>. For a complete list of languages supported by this method, see <a href="http://src.chromium.org/viewvc/chrome/trunk/src/third_party/cld/languages/internal/languages.cc">kLanguageInfoTable</a>. The 2nd to 4th columns will be checked and the first non-NULL value will be returned except for Simplified Chinese for which zh-CN will be returned. For an unknown language, <code>und</code> will be returned.</dd> 2056 <dd style="display: none; "> 2057 This parameter was added in version 2058 <b><span></span></b>. 2059 You must omit this parameter in earlier versions, 2060 and you may omit it in any version. If you require this 2061 parameter, the manifest key 2062 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2063 can ensure that your extension won't be run in an earlier browser version. 2064 </dd> 2065 2066 <!-- OBJECT PROPERTIES --> 2067 <dd style="display: none; "> 2068 <dl> 2069 <div> 2070 <div> 2071 </div> 2072 </div> 2073 </dl> 2074 </dd> 2075 2076 <!-- OBJECT METHODS --> 2077 <dd style="display: none; "> 2078 <div></div> 2079 </dd> 2080 2081 <!-- OBJECT EVENT FIELDS --> 2082 <dd style="display: none; "> 2083 <div></div> 2084 </dd> 2085 2086 <!-- FUNCTION PARAMETERS --> 2087 <dd style="display: none; "> 2088 <div></div> 2089 </dd> 2090 2091 </div> 2092 </div> 2093 </dl> 2094 </div> 2095 </div> 2096 2097 <!-- MIN_VERSION --> 2098 <p style="display: none; "> 2099 This function was added in version <b><span></span></b>. 2100 If you require this function, the manifest key 2101 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2102 can ensure that your extension won't be run in an earlier browser version. 2103 </p> 2104 </div> <!-- /description --> 2105 2106 </div><div class="apiItem"> 2107 <a name="method-executeScript"></a> <!-- method-anchor --> 2108 <h4>executeScript</h4> 2109 2110 <div class="summary"><span style="display: none; ">void</span> 2111 <!-- Note: intentionally longer 80 columns --> 2112 <span>chrome.tabs.executeScript</span>(<span class="optional"><span style="display: none; ">, </span><span>integer</span> 2113 <var><span>tabId</span></var></span><span class="null"><span>, </span><span>object</span> 2114 <var><span>details</span></var></span><span class="optional"><span>, </span><span>function</span> 2115 <var><span>callback</span></var></span>)</div> 2116 2117 <div class="description"> 2118 <p class="todo" style="display: none; ">Undocumented.</p> 2119 <p>Injects JavaScript code into a page. For details, see the <a href="content_scripts.html#pi">programmatic injection</a> section of the content scripts doc.</p> 2120 2121 <!-- PARAMETERS --> 2122 <h4>Parameters</h4> 2123 <dl> 2124 <div> 2125 <div> 2126 <dt> 2127 <var>tabId</var> 2128 <em> 2129 2130 <!-- TYPE --> 2131 <div style="display:inline"> 2132 ( 2133 <span class="optional">optional</span> 2134 <span class="enum" style="display: none; ">enumerated</span> 2135 <span id="typeTemplate"> 2136 <span style="display: none; "> 2137 <a> Type</a> 2138 </span> 2139 <span> 2140 <span style="display: none; "> 2141 array of <span><span></span></span> 2142 </span> 2143 <span>integer</span> 2144 <span style="display: none; "></span> 2145 </span> 2146 </span> 2147 ) 2148 </div> 2149 2150 </em> 2151 </dt> 2152 <dd class="todo" style="display: none; "> 2153 Undocumented. 2154 </dd> 2155 <dd>The ID of the tab in which to run the script; defaults to the selected tab of the current window.</dd> 2156 <dd style="display: none; "> 2157 This parameter was added in version 2158 <b><span></span></b>. 2159 You must omit this parameter in earlier versions, 2160 and you may omit it in any version. If you require this 2161 parameter, the manifest key 2162 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2163 can ensure that your extension won't be run in an earlier browser version. 2164 </dd> 2165 2166 <!-- OBJECT PROPERTIES --> 2167 <dd style="display: none; "> 2168 <dl> 2169 <div> 2170 <div> 2171 </div> 2172 </div> 2173 </dl> 2174 </dd> 2175 2176 <!-- OBJECT METHODS --> 2177 <dd style="display: none; "> 2178 <div></div> 2179 </dd> 2180 2181 <!-- OBJECT EVENT FIELDS --> 2182 <dd style="display: none; "> 2183 <div></div> 2184 </dd> 2185 2186 <!-- FUNCTION PARAMETERS --> 2187 <dd style="display: none; "> 2188 <div></div> 2189 </dd> 2190 2191 </div> 2192 </div><div> 2193 <div> 2194 <dt> 2195 <var>details</var> 2196 <em> 2197 2198 <!-- TYPE --> 2199 <div style="display:inline"> 2200 ( 2201 <span class="optional" style="display: none; ">optional</span> 2202 <span class="enum" style="display: none; ">enumerated</span> 2203 <span id="typeTemplate"> 2204 <span style="display: none; "> 2205 <a> Type</a> 2206 </span> 2207 <span> 2208 <span style="display: none; "> 2209 array of <span><span></span></span> 2210 </span> 2211 <span>object</span> 2212 <span style="display: none; "></span> 2213 </span> 2214 </span> 2215 ) 2216 </div> 2217 2218 </em> 2219 </dt> 2220 <dd class="todo" style="display: none; "> 2221 Undocumented. 2222 </dd> 2223 <dd>Details of the script to run. Either the code or the file property must be set, but both may not be set at the same time.</dd> 2224 <dd style="display: none; "> 2225 This parameter was added in version 2226 <b><span></span></b>. 2227 You must omit this parameter in earlier versions, 2228 and you may omit it in any version. If you require this 2229 parameter, the manifest key 2230 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2231 can ensure that your extension won't be run in an earlier browser version. 2232 </dd> 2233 2234 <!-- OBJECT PROPERTIES --> 2235 <dd> 2236 <dl> 2237 <div> 2238 <div> 2239 <dt> 2240 <var>code</var> 2241 <em> 2242 2243 <!-- TYPE --> 2244 <div style="display:inline"> 2245 ( 2246 <span class="optional">optional</span> 2247 <span class="enum" style="display: none; ">enumerated</span> 2248 <span id="typeTemplate"> 2249 <span style="display: none; "> 2250 <a> Type</a> 2251 </span> 2252 <span> 2253 <span style="display: none; "> 2254 array of <span><span></span></span> 2255 </span> 2256 <span>string</span> 2257 <span style="display: none; "></span> 2258 </span> 2259 </span> 2260 ) 2261 </div> 2262 2263 </em> 2264 </dt> 2265 <dd class="todo" style="display: none; "> 2266 Undocumented. 2267 </dd> 2268 <dd>JavaScript code to execute.</dd> 2269 <dd style="display: none; "> 2270 This parameter was added in version 2271 <b><span></span></b>. 2272 You must omit this parameter in earlier versions, 2273 and you may omit it in any version. If you require this 2274 parameter, the manifest key 2275 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2276 can ensure that your extension won't be run in an earlier browser version. 2277 </dd> 2278 2279 <!-- OBJECT PROPERTIES --> 2280 <dd style="display: none; "> 2281 <dl> 2282 <div> 2283 <div> 2284 </div> 2285 </div> 2286 </dl> 2287 </dd> 2288 2289 <!-- OBJECT METHODS --> 2290 <dd style="display: none; "> 2291 <div></div> 2292 </dd> 2293 2294 <!-- OBJECT EVENT FIELDS --> 2295 <dd style="display: none; "> 2296 <div></div> 2297 </dd> 2298 2299 <!-- FUNCTION PARAMETERS --> 2300 <dd style="display: none; "> 2301 <div></div> 2302 </dd> 2303 2304 </div> 2305 </div><div> 2306 <div> 2307 <dt> 2308 <var>file</var> 2309 <em> 2310 2311 <!-- TYPE --> 2312 <div style="display:inline"> 2313 ( 2314 <span class="optional">optional</span> 2315 <span class="enum" style="display: none; ">enumerated</span> 2316 <span id="typeTemplate"> 2317 <span style="display: none; "> 2318 <a> Type</a> 2319 </span> 2320 <span> 2321 <span style="display: none; "> 2322 array of <span><span></span></span> 2323 </span> 2324 <span>string</span> 2325 <span style="display: none; "></span> 2326 </span> 2327 </span> 2328 ) 2329 </div> 2330 2331 </em> 2332 </dt> 2333 <dd class="todo" style="display: none; "> 2334 Undocumented. 2335 </dd> 2336 <dd>JavaScript file to execute.</dd> 2337 <dd style="display: none; "> 2338 This parameter was added in version 2339 <b><span></span></b>. 2340 You must omit this parameter in earlier versions, 2341 and you may omit it in any version. If you require this 2342 parameter, the manifest key 2343 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2344 can ensure that your extension won't be run in an earlier browser version. 2345 </dd> 2346 2347 <!-- OBJECT PROPERTIES --> 2348 <dd style="display: none; "> 2349 <dl> 2350 <div> 2351 <div> 2352 </div> 2353 </div> 2354 </dl> 2355 </dd> 2356 2357 <!-- OBJECT METHODS --> 2358 <dd style="display: none; "> 2359 <div></div> 2360 </dd> 2361 2362 <!-- OBJECT EVENT FIELDS --> 2363 <dd style="display: none; "> 2364 <div></div> 2365 </dd> 2366 2367 <!-- FUNCTION PARAMETERS --> 2368 <dd style="display: none; "> 2369 <div></div> 2370 </dd> 2371 2372 </div> 2373 </div><div> 2374 <div> 2375 <dt> 2376 <var>allFrames</var> 2377 <em> 2378 2379 <!-- TYPE --> 2380 <div style="display:inline"> 2381 ( 2382 <span class="optional">optional</span> 2383 <span class="enum" style="display: none; ">enumerated</span> 2384 <span id="typeTemplate"> 2385 <span style="display: none; "> 2386 <a> Type</a> 2387 </span> 2388 <span> 2389 <span style="display: none; "> 2390 array of <span><span></span></span> 2391 </span> 2392 <span>boolean</span> 2393 <span style="display: none; "></span> 2394 </span> 2395 </span> 2396 ) 2397 </div> 2398 2399 </em> 2400 </dt> 2401 <dd class="todo" style="display: none; "> 2402 Undocumented. 2403 </dd> 2404 <dd>If allFrames is true, this function injects script into all frames of current page. By default, it's false and script is injected only into the top main frame.</dd> 2405 <dd style="display: none; "> 2406 This parameter was added in version 2407 <b><span></span></b>. 2408 You must omit this parameter in earlier versions, 2409 and you may omit it in any version. If you require this 2410 parameter, the manifest key 2411 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2412 can ensure that your extension won't be run in an earlier browser version. 2413 </dd> 2414 2415 <!-- OBJECT PROPERTIES --> 2416 <dd style="display: none; "> 2417 <dl> 2418 <div> 2419 <div> 2420 </div> 2421 </div> 2422 </dl> 2423 </dd> 2424 2425 <!-- OBJECT METHODS --> 2426 <dd style="display: none; "> 2427 <div></div> 2428 </dd> 2429 2430 <!-- OBJECT EVENT FIELDS --> 2431 <dd style="display: none; "> 2432 <div></div> 2433 </dd> 2434 2435 <!-- FUNCTION PARAMETERS --> 2436 <dd style="display: none; "> 2437 <div></div> 2438 </dd> 2439 2440 </div> 2441 </div> 2442 </dl> 2443 </dd> 2444 2445 <!-- OBJECT METHODS --> 2446 <dd style="display: none; "> 2447 <div></div> 2448 </dd> 2449 2450 <!-- OBJECT EVENT FIELDS --> 2451 <dd style="display: none; "> 2452 <div></div> 2453 </dd> 2454 2455 <!-- FUNCTION PARAMETERS --> 2456 <dd style="display: none; "> 2457 <div></div> 2458 </dd> 2459 2460 </div> 2461 </div><div> 2462 <div> 2463 <dt> 2464 <var>callback</var> 2465 <em> 2466 2467 <!-- TYPE --> 2468 <div style="display:inline"> 2469 ( 2470 <span class="optional">optional</span> 2471 <span class="enum" style="display: none; ">enumerated</span> 2472 <span id="typeTemplate"> 2473 <span style="display: none; "> 2474 <a> Type</a> 2475 </span> 2476 <span> 2477 <span style="display: none; "> 2478 array of <span><span></span></span> 2479 </span> 2480 <span>function</span> 2481 <span style="display: none; "></span> 2482 </span> 2483 </span> 2484 ) 2485 </div> 2486 2487 </em> 2488 </dt> 2489 <dd class="todo" style="display: none; "> 2490 Undocumented. 2491 </dd> 2492 <dd>Called after all the JavaScript has been executed.</dd> 2493 <dd style="display: none; "> 2494 This parameter was added in version 2495 <b><span></span></b>. 2496 You must omit this parameter in earlier versions, 2497 and you may omit it in any version. If you require this 2498 parameter, the manifest key 2499 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2500 can ensure that your extension won't be run in an earlier browser version. 2501 </dd> 2502 2503 <!-- OBJECT PROPERTIES --> 2504 <dd style="display: none; "> 2505 <dl> 2506 <div> 2507 <div> 2508 </div> 2509 </div> 2510 </dl> 2511 </dd> 2512 2513 <!-- OBJECT METHODS --> 2514 <dd style="display: none; "> 2515 <div></div> 2516 </dd> 2517 2518 <!-- OBJECT EVENT FIELDS --> 2519 <dd style="display: none; "> 2520 <div></div> 2521 </dd> 2522 2523 <!-- FUNCTION PARAMETERS --> 2524 <dd style="display: none; "> 2525 <div></div> 2526 </dd> 2527 2528 </div> 2529 </div> 2530 </dl> 2531 2532 <!-- RETURNS --> 2533 <h4 style="display: none; ">Returns</h4> 2534 <dl> 2535 <div style="display: none; "> 2536 <div> 2537 </div> 2538 </div> 2539 </dl> 2540 2541 <!-- CALLBACK --> 2542 <div> 2543 <div> 2544 <h4>Callback function</h4> 2545 <p style="display: none; "> 2546 The callback <em>parameter</em> should specify a function 2547 that looks like this: 2548 </p> 2549 <p> 2550 If you specify the <em>callback</em> parameter, it should 2551 specify a function that looks like this: 2552 </p> 2553 2554 <!-- Note: intentionally longer 80 columns --> 2555 <pre>function(<span></span>) <span class="subdued">{...}</span>;</pre> 2556 <dl> 2557 <div style="display: none; "> 2558 <div> 2559 </div> 2560 </div> 2561 </dl> 2562 </div> 2563 </div> 2564 2565 <!-- MIN_VERSION --> 2566 <p style="display: none; "> 2567 This function was added in version <b><span></span></b>. 2568 If you require this function, the manifest key 2569 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2570 can ensure that your extension won't be run in an earlier browser version. 2571 </p> 2572 </div> <!-- /description --> 2573 2574 </div><div class="apiItem"> 2575 <a name="method-get"></a> <!-- method-anchor --> 2576 <h4>get</h4> 2577 2578 <div class="summary"><span style="display: none; ">void</span> 2579 <!-- Note: intentionally longer 80 columns --> 2580 <span>chrome.tabs.get</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 2581 <var><span>tabId</span></var></span><span class="null"><span>, </span><span>function</span> 2582 <var><span>callback</span></var></span>)</div> 2583 2584 <div class="description"> 2585 <p class="todo" style="display: none; ">Undocumented.</p> 2586 <p>Retrieves details about the specified tab.</p> 2587 2588 <!-- PARAMETERS --> 2589 <h4>Parameters</h4> 2590 <dl> 2591 <div> 2592 <div> 2593 <dt> 2594 <var>tabId</var> 2595 <em> 2596 2597 <!-- TYPE --> 2598 <div style="display:inline"> 2599 ( 2600 <span class="optional" style="display: none; ">optional</span> 2601 <span class="enum" style="display: none; ">enumerated</span> 2602 <span id="typeTemplate"> 2603 <span style="display: none; "> 2604 <a> Type</a> 2605 </span> 2606 <span> 2607 <span style="display: none; "> 2608 array of <span><span></span></span> 2609 </span> 2610 <span>integer</span> 2611 <span style="display: none; "></span> 2612 </span> 2613 </span> 2614 ) 2615 </div> 2616 2617 </em> 2618 </dt> 2619 <dd class="todo"> 2620 Undocumented. 2621 </dd> 2622 <dd style="display: none; "> 2623 Description of this parameter from the json schema. 2624 </dd> 2625 <dd style="display: none; "> 2626 This parameter was added in version 2627 <b><span></span></b>. 2628 You must omit this parameter in earlier versions, 2629 and you may omit it in any version. If you require this 2630 parameter, the manifest key 2631 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2632 can ensure that your extension won't be run in an earlier browser version. 2633 </dd> 2634 2635 <!-- OBJECT PROPERTIES --> 2636 <dd style="display: none; "> 2637 <dl> 2638 <div> 2639 <div> 2640 </div> 2641 </div> 2642 </dl> 2643 </dd> 2644 2645 <!-- OBJECT METHODS --> 2646 <dd style="display: none; "> 2647 <div></div> 2648 </dd> 2649 2650 <!-- OBJECT EVENT FIELDS --> 2651 <dd style="display: none; "> 2652 <div></div> 2653 </dd> 2654 2655 <!-- FUNCTION PARAMETERS --> 2656 <dd style="display: none; "> 2657 <div></div> 2658 </dd> 2659 2660 </div> 2661 </div><div> 2662 <div> 2663 <dt> 2664 <var>callback</var> 2665 <em> 2666 2667 <!-- TYPE --> 2668 <div style="display:inline"> 2669 ( 2670 <span class="optional" style="display: none; ">optional</span> 2671 <span class="enum" style="display: none; ">enumerated</span> 2672 <span id="typeTemplate"> 2673 <span style="display: none; "> 2674 <a> Type</a> 2675 </span> 2676 <span> 2677 <span style="display: none; "> 2678 array of <span><span></span></span> 2679 </span> 2680 <span>function</span> 2681 <span style="display: none; "></span> 2682 </span> 2683 </span> 2684 ) 2685 </div> 2686 2687 </em> 2688 </dt> 2689 <dd class="todo"> 2690 Undocumented. 2691 </dd> 2692 <dd style="display: none; "> 2693 Description of this parameter from the json schema. 2694 </dd> 2695 <dd style="display: none; "> 2696 This parameter was added in version 2697 <b><span></span></b>. 2698 You must omit this parameter in earlier versions, 2699 and you may omit it in any version. If you require this 2700 parameter, the manifest key 2701 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2702 can ensure that your extension won't be run in an earlier browser version. 2703 </dd> 2704 2705 <!-- OBJECT PROPERTIES --> 2706 <dd style="display: none; "> 2707 <dl> 2708 <div> 2709 <div> 2710 </div> 2711 </div> 2712 </dl> 2713 </dd> 2714 2715 <!-- OBJECT METHODS --> 2716 <dd style="display: none; "> 2717 <div></div> 2718 </dd> 2719 2720 <!-- OBJECT EVENT FIELDS --> 2721 <dd style="display: none; "> 2722 <div></div> 2723 </dd> 2724 2725 <!-- FUNCTION PARAMETERS --> 2726 <dd style="display: none; "> 2727 <div></div> 2728 </dd> 2729 2730 </div> 2731 </div> 2732 </dl> 2733 2734 <!-- RETURNS --> 2735 <h4 style="display: none; ">Returns</h4> 2736 <dl> 2737 <div style="display: none; "> 2738 <div> 2739 </div> 2740 </div> 2741 </dl> 2742 2743 <!-- CALLBACK --> 2744 <div> 2745 <div> 2746 <h4>Callback function</h4> 2747 <p> 2748 The callback <em>parameter</em> should specify a function 2749 that looks like this: 2750 </p> 2751 <p style="display: none; "> 2752 If you specify the <em>callback</em> parameter, it should 2753 specify a function that looks like this: 2754 </p> 2755 2756 <!-- Note: intentionally longer 80 columns --> 2757 <pre>function(<span>Tab tab</span>) <span class="subdued">{...}</span>;</pre> 2758 <dl> 2759 <div> 2760 <div> 2761 <dt> 2762 <var>tab</var> 2763 <em> 2764 2765 <!-- TYPE --> 2766 <div style="display:inline"> 2767 ( 2768 <span class="optional" style="display: none; ">optional</span> 2769 <span class="enum" style="display: none; ">enumerated</span> 2770 <span id="typeTemplate"> 2771 <span> 2772 <a href="tabs.html#type-Tab">Tab</a> 2773 </span> 2774 <span style="display: none; "> 2775 <span> 2776 array of <span><span></span></span> 2777 </span> 2778 <span>paramType</span> 2779 <span></span> 2780 </span> 2781 </span> 2782 ) 2783 </div> 2784 2785 </em> 2786 </dt> 2787 <dd class="todo"> 2788 Undocumented. 2789 </dd> 2790 <dd style="display: none; "> 2791 Description of this parameter from the json schema. 2792 </dd> 2793 <dd style="display: none; "> 2794 This parameter was added in version 2795 <b><span></span></b>. 2796 You must omit this parameter in earlier versions, 2797 and you may omit it in any version. If you require this 2798 parameter, the manifest key 2799 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2800 can ensure that your extension won't be run in an earlier browser version. 2801 </dd> 2802 2803 <!-- OBJECT PROPERTIES --> 2804 <dd style="display: none; "> 2805 <dl> 2806 <div> 2807 <div> 2808 </div> 2809 </div> 2810 </dl> 2811 </dd> 2812 2813 <!-- OBJECT METHODS --> 2814 <dd style="display: none; "> 2815 <div></div> 2816 </dd> 2817 2818 <!-- OBJECT EVENT FIELDS --> 2819 <dd style="display: none; "> 2820 <div></div> 2821 </dd> 2822 2823 <!-- FUNCTION PARAMETERS --> 2824 <dd style="display: none; "> 2825 <div></div> 2826 </dd> 2827 2828 </div> 2829 </div> 2830 </dl> 2831 </div> 2832 </div> 2833 2834 <!-- MIN_VERSION --> 2835 <p style="display: none; "> 2836 This function was added in version <b><span></span></b>. 2837 If you require this function, the manifest key 2838 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2839 can ensure that your extension won't be run in an earlier browser version. 2840 </p> 2841 </div> <!-- /description --> 2842 2843 </div><div class="apiItem"> 2844 <a name="method-getAllInWindow"></a> <!-- method-anchor --> 2845 <h4>getAllInWindow</h4> 2846 2847 <div class="summary"><span style="display: none; ">void</span> 2848 <!-- Note: intentionally longer 80 columns --> 2849 <span>chrome.tabs.getAllInWindow</span>(<span class="optional"><span style="display: none; ">, </span><span>integer</span> 2850 <var><span>windowId</span></var></span><span class="null"><span>, </span><span>function</span> 2851 <var><span>callback</span></var></span>)</div> 2852 2853 <div class="description"> 2854 <p class="todo" style="display: none; ">Undocumented.</p> 2855 <p>Gets details about all tabs in the specified window.</p> 2856 2857 <!-- PARAMETERS --> 2858 <h4>Parameters</h4> 2859 <dl> 2860 <div> 2861 <div> 2862 <dt> 2863 <var>windowId</var> 2864 <em> 2865 2866 <!-- TYPE --> 2867 <div style="display:inline"> 2868 ( 2869 <span class="optional">optional</span> 2870 <span class="enum" style="display: none; ">enumerated</span> 2871 <span id="typeTemplate"> 2872 <span style="display: none; "> 2873 <a> Type</a> 2874 </span> 2875 <span> 2876 <span style="display: none; "> 2877 array of <span><span></span></span> 2878 </span> 2879 <span>integer</span> 2880 <span style="display: none; "></span> 2881 </span> 2882 </span> 2883 ) 2884 </div> 2885 2886 </em> 2887 </dt> 2888 <dd class="todo" style="display: none; "> 2889 Undocumented. 2890 </dd> 2891 <dd>Defaults to the <a href="windows.html#current-window">current window</a>.</dd> 2892 <dd style="display: none; "> 2893 This parameter was added in version 2894 <b><span></span></b>. 2895 You must omit this parameter in earlier versions, 2896 and you may omit it in any version. If you require this 2897 parameter, the manifest key 2898 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2899 can ensure that your extension won't be run in an earlier browser version. 2900 </dd> 2901 2902 <!-- OBJECT PROPERTIES --> 2903 <dd style="display: none; "> 2904 <dl> 2905 <div> 2906 <div> 2907 </div> 2908 </div> 2909 </dl> 2910 </dd> 2911 2912 <!-- OBJECT METHODS --> 2913 <dd style="display: none; "> 2914 <div></div> 2915 </dd> 2916 2917 <!-- OBJECT EVENT FIELDS --> 2918 <dd style="display: none; "> 2919 <div></div> 2920 </dd> 2921 2922 <!-- FUNCTION PARAMETERS --> 2923 <dd style="display: none; "> 2924 <div></div> 2925 </dd> 2926 2927 </div> 2928 </div><div> 2929 <div> 2930 <dt> 2931 <var>callback</var> 2932 <em> 2933 2934 <!-- TYPE --> 2935 <div style="display:inline"> 2936 ( 2937 <span class="optional" style="display: none; ">optional</span> 2938 <span class="enum" style="display: none; ">enumerated</span> 2939 <span id="typeTemplate"> 2940 <span style="display: none; "> 2941 <a> Type</a> 2942 </span> 2943 <span> 2944 <span style="display: none; "> 2945 array of <span><span></span></span> 2946 </span> 2947 <span>function</span> 2948 <span style="display: none; "></span> 2949 </span> 2950 </span> 2951 ) 2952 </div> 2953 2954 </em> 2955 </dt> 2956 <dd class="todo"> 2957 Undocumented. 2958 </dd> 2959 <dd style="display: none; "> 2960 Description of this parameter from the json schema. 2961 </dd> 2962 <dd style="display: none; "> 2963 This parameter was added in version 2964 <b><span></span></b>. 2965 You must omit this parameter in earlier versions, 2966 and you may omit it in any version. If you require this 2967 parameter, the manifest key 2968 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2969 can ensure that your extension won't be run in an earlier browser version. 2970 </dd> 2971 2972 <!-- OBJECT PROPERTIES --> 2973 <dd style="display: none; "> 2974 <dl> 2975 <div> 2976 <div> 2977 </div> 2978 </div> 2979 </dl> 2980 </dd> 2981 2982 <!-- OBJECT METHODS --> 2983 <dd style="display: none; "> 2984 <div></div> 2985 </dd> 2986 2987 <!-- OBJECT EVENT FIELDS --> 2988 <dd style="display: none; "> 2989 <div></div> 2990 </dd> 2991 2992 <!-- FUNCTION PARAMETERS --> 2993 <dd style="display: none; "> 2994 <div></div> 2995 </dd> 2996 2997 </div> 2998 </div> 2999 </dl> 3000 3001 <!-- RETURNS --> 3002 <h4 style="display: none; ">Returns</h4> 3003 <dl> 3004 <div style="display: none; "> 3005 <div> 3006 </div> 3007 </div> 3008 </dl> 3009 3010 <!-- CALLBACK --> 3011 <div> 3012 <div> 3013 <h4>Callback function</h4> 3014 <p> 3015 The callback <em>parameter</em> should specify a function 3016 that looks like this: 3017 </p> 3018 <p style="display: none; "> 3019 If you specify the <em>callback</em> parameter, it should 3020 specify a function that looks like this: 3021 </p> 3022 3023 <!-- Note: intentionally longer 80 columns --> 3024 <pre>function(<span>array of Tab tabs</span>) <span class="subdued">{...}</span>;</pre> 3025 <dl> 3026 <div> 3027 <div> 3028 <dt> 3029 <var>tabs</var> 3030 <em> 3031 3032 <!-- TYPE --> 3033 <div style="display:inline"> 3034 ( 3035 <span class="optional" style="display: none; ">optional</span> 3036 <span class="enum" style="display: none; ">enumerated</span> 3037 <span id="typeTemplate"> 3038 <span style="display: none; "> 3039 <a> Type</a> 3040 </span> 3041 <span> 3042 <span> 3043 array of <span><span> 3044 <span> 3045 <a href="tabs.html#type-Tab">Tab</a> 3046 </span> 3047 <span style="display: none; "> 3048 <span> 3049 array of <span><span></span></span> 3050 </span> 3051 <span>paramType</span> 3052 <span></span> 3053 </span> 3054 </span></span> 3055 </span> 3056 <span style="display: none; ">paramType</span> 3057 <span style="display: none; "></span> 3058 </span> 3059 </span> 3060 ) 3061 </div> 3062 3063 </em> 3064 </dt> 3065 <dd class="todo"> 3066 Undocumented. 3067 </dd> 3068 <dd style="display: none; "> 3069 Description of this parameter from the json schema. 3070 </dd> 3071 <dd style="display: none; "> 3072 This parameter was added in version 3073 <b><span></span></b>. 3074 You must omit this parameter in earlier versions, 3075 and you may omit it in any version. If you require this 3076 parameter, the manifest key 3077 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3078 can ensure that your extension won't be run in an earlier browser version. 3079 </dd> 3080 3081 <!-- OBJECT PROPERTIES --> 3082 <dd style="display: none; "> 3083 <dl> 3084 <div> 3085 <div> 3086 </div> 3087 </div> 3088 </dl> 3089 </dd> 3090 3091 <!-- OBJECT METHODS --> 3092 <dd style="display: none; "> 3093 <div></div> 3094 </dd> 3095 3096 <!-- OBJECT EVENT FIELDS --> 3097 <dd style="display: none; "> 3098 <div></div> 3099 </dd> 3100 3101 <!-- FUNCTION PARAMETERS --> 3102 <dd style="display: none; "> 3103 <div></div> 3104 </dd> 3105 3106 </div> 3107 </div> 3108 </dl> 3109 </div> 3110 </div> 3111 3112 <!-- MIN_VERSION --> 3113 <p style="display: none; "> 3114 This function was added in version <b><span></span></b>. 3115 If you require this function, the manifest key 3116 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3117 can ensure that your extension won't be run in an earlier browser version. 3118 </p> 3119 </div> <!-- /description --> 3120 3121 </div><div class="apiItem"> 3122 <a name="method-getCurrent"></a> <!-- method-anchor --> 3123 <h4>getCurrent</h4> 3124 3125 <div class="summary"><span style="display: none; ">void</span> 3126 <!-- Note: intentionally longer 80 columns --> 3127 <span>chrome.tabs.getCurrent</span>(<span class="null"><span style="display: none; ">, </span><span>function</span> 3128 <var><span>callback</span></var></span>)</div> 3129 3130 <div class="description"> 3131 <p class="todo" style="display: none; ">Undocumented.</p> 3132 <p>Gets the tab that this script call is being made from. May be undefined if called from a non-tab context (for example: a background page or popup view).</p> 3133 3134 <!-- PARAMETERS --> 3135 <h4>Parameters</h4> 3136 <dl> 3137 <div> 3138 <div> 3139 <dt> 3140 <var>callback</var> 3141 <em> 3142 3143 <!-- TYPE --> 3144 <div style="display:inline"> 3145 ( 3146 <span class="optional" style="display: none; ">optional</span> 3147 <span class="enum" style="display: none; ">enumerated</span> 3148 <span id="typeTemplate"> 3149 <span style="display: none; "> 3150 <a> Type</a> 3151 </span> 3152 <span> 3153 <span style="display: none; "> 3154 array of <span><span></span></span> 3155 </span> 3156 <span>function</span> 3157 <span style="display: none; "></span> 3158 </span> 3159 </span> 3160 ) 3161 </div> 3162 3163 </em> 3164 </dt> 3165 <dd class="todo"> 3166 Undocumented. 3167 </dd> 3168 <dd style="display: none; "> 3169 Description of this parameter from the json schema. 3170 </dd> 3171 <dd style="display: none; "> 3172 This parameter was added in version 3173 <b><span></span></b>. 3174 You must omit this parameter in earlier versions, 3175 and you may omit it in any version. If you require this 3176 parameter, the manifest key 3177 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3178 can ensure that your extension won't be run in an earlier browser version. 3179 </dd> 3180 3181 <!-- OBJECT PROPERTIES --> 3182 <dd style="display: none; "> 3183 <dl> 3184 <div> 3185 <div> 3186 </div> 3187 </div> 3188 </dl> 3189 </dd> 3190 3191 <!-- OBJECT METHODS --> 3192 <dd style="display: none; "> 3193 <div></div> 3194 </dd> 3195 3196 <!-- OBJECT EVENT FIELDS --> 3197 <dd style="display: none; "> 3198 <div></div> 3199 </dd> 3200 3201 <!-- FUNCTION PARAMETERS --> 3202 <dd style="display: none; "> 3203 <div></div> 3204 </dd> 3205 3206 </div> 3207 </div> 3208 </dl> 3209 3210 <!-- RETURNS --> 3211 <h4 style="display: none; ">Returns</h4> 3212 <dl> 3213 <div style="display: none; "> 3214 <div> 3215 </div> 3216 </div> 3217 </dl> 3218 3219 <!-- CALLBACK --> 3220 <div> 3221 <div> 3222 <h4>Callback function</h4> 3223 <p> 3224 The callback <em>parameter</em> should specify a function 3225 that looks like this: 3226 </p> 3227 <p style="display: none; "> 3228 If you specify the <em>callback</em> parameter, it should 3229 specify a function that looks like this: 3230 </p> 3231 3232 <!-- Note: intentionally longer 80 columns --> 3233 <pre>function(<span>Tab tab</span>) <span class="subdued">{...}</span>;</pre> 3234 <dl> 3235 <div> 3236 <div> 3237 <dt> 3238 <var>tab</var> 3239 <em> 3240 3241 <!-- TYPE --> 3242 <div style="display:inline"> 3243 ( 3244 <span class="optional">optional</span> 3245 <span class="enum" style="display: none; ">enumerated</span> 3246 <span id="typeTemplate"> 3247 <span> 3248 <a href="tabs.html#type-Tab">Tab</a> 3249 </span> 3250 <span style="display: none; "> 3251 <span> 3252 array of <span><span></span></span> 3253 </span> 3254 <span>paramType</span> 3255 <span></span> 3256 </span> 3257 </span> 3258 ) 3259 </div> 3260 3261 </em> 3262 </dt> 3263 <dd class="todo"> 3264 Undocumented. 3265 </dd> 3266 <dd style="display: none; "> 3267 Description of this parameter from the json schema. 3268 </dd> 3269 <dd style="display: none; "> 3270 This parameter was added in version 3271 <b><span></span></b>. 3272 You must omit this parameter in earlier versions, 3273 and you may omit it in any version. If you require this 3274 parameter, the manifest key 3275 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3276 can ensure that your extension won't be run in an earlier browser version. 3277 </dd> 3278 3279 <!-- OBJECT PROPERTIES --> 3280 <dd style="display: none; "> 3281 <dl> 3282 <div> 3283 <div> 3284 </div> 3285 </div> 3286 </dl> 3287 </dd> 3288 3289 <!-- OBJECT METHODS --> 3290 <dd style="display: none; "> 3291 <div></div> 3292 </dd> 3293 3294 <!-- OBJECT EVENT FIELDS --> 3295 <dd style="display: none; "> 3296 <div></div> 3297 </dd> 3298 3299 <!-- FUNCTION PARAMETERS --> 3300 <dd style="display: none; "> 3301 <div></div> 3302 </dd> 3303 3304 </div> 3305 </div> 3306 </dl> 3307 </div> 3308 </div> 3309 3310 <!-- MIN_VERSION --> 3311 <p style="display: none; "> 3312 This function was added in version <b><span></span></b>. 3313 If you require this function, the manifest key 3314 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3315 can ensure that your extension won't be run in an earlier browser version. 3316 </p> 3317 </div> <!-- /description --> 3318 3319 </div><div class="apiItem"> 3320 <a name="method-getSelected"></a> <!-- method-anchor --> 3321 <h4>getSelected</h4> 3322 3323 <div class="summary"><span style="display: none; ">void</span> 3324 <!-- Note: intentionally longer 80 columns --> 3325 <span>chrome.tabs.getSelected</span>(<span class="optional"><span style="display: none; ">, </span><span>integer</span> 3326 <var><span>windowId</span></var></span><span class="null"><span>, </span><span>function</span> 3327 <var><span>callback</span></var></span>)</div> 3328 3329 <div class="description"> 3330 <p class="todo" style="display: none; ">Undocumented.</p> 3331 <p>Gets the tab that is selected in the specified window.</p> 3332 3333 <!-- PARAMETERS --> 3334 <h4>Parameters</h4> 3335 <dl> 3336 <div> 3337 <div> 3338 <dt> 3339 <var>windowId</var> 3340 <em> 3341 3342 <!-- TYPE --> 3343 <div style="display:inline"> 3344 ( 3345 <span class="optional">optional</span> 3346 <span class="enum" style="display: none; ">enumerated</span> 3347 <span id="typeTemplate"> 3348 <span style="display: none; "> 3349 <a> Type</a> 3350 </span> 3351 <span> 3352 <span style="display: none; "> 3353 array of <span><span></span></span> 3354 </span> 3355 <span>integer</span> 3356 <span style="display: none; "></span> 3357 </span> 3358 </span> 3359 ) 3360 </div> 3361 3362 </em> 3363 </dt> 3364 <dd class="todo" style="display: none; "> 3365 Undocumented. 3366 </dd> 3367 <dd>Defaults to the <a href="windows.html#current-window">current window</a>.</dd> 3368 <dd style="display: none; "> 3369 This parameter was added in version 3370 <b><span></span></b>. 3371 You must omit this parameter in earlier versions, 3372 and you may omit it in any version. If you require this 3373 parameter, the manifest key 3374 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3375 can ensure that your extension won't be run in an earlier browser version. 3376 </dd> 3377 3378 <!-- OBJECT PROPERTIES --> 3379 <dd style="display: none; "> 3380 <dl> 3381 <div> 3382 <div> 3383 </div> 3384 </div> 3385 </dl> 3386 </dd> 3387 3388 <!-- OBJECT METHODS --> 3389 <dd style="display: none; "> 3390 <div></div> 3391 </dd> 3392 3393 <!-- OBJECT EVENT FIELDS --> 3394 <dd style="display: none; "> 3395 <div></div> 3396 </dd> 3397 3398 <!-- FUNCTION PARAMETERS --> 3399 <dd style="display: none; "> 3400 <div></div> 3401 </dd> 3402 3403 </div> 3404 </div><div> 3405 <div> 3406 <dt> 3407 <var>callback</var> 3408 <em> 3409 3410 <!-- TYPE --> 3411 <div style="display:inline"> 3412 ( 3413 <span class="optional" style="display: none; ">optional</span> 3414 <span class="enum" style="display: none; ">enumerated</span> 3415 <span id="typeTemplate"> 3416 <span style="display: none; "> 3417 <a> Type</a> 3418 </span> 3419 <span> 3420 <span style="display: none; "> 3421 array of <span><span></span></span> 3422 </span> 3423 <span>function</span> 3424 <span style="display: none; "></span> 3425 </span> 3426 </span> 3427 ) 3428 </div> 3429 3430 </em> 3431 </dt> 3432 <dd class="todo"> 3433 Undocumented. 3434 </dd> 3435 <dd style="display: none; "> 3436 Description of this parameter from the json schema. 3437 </dd> 3438 <dd style="display: none; "> 3439 This parameter was added in version 3440 <b><span></span></b>. 3441 You must omit this parameter in earlier versions, 3442 and you may omit it in any version. If you require this 3443 parameter, the manifest key 3444 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3445 can ensure that your extension won't be run in an earlier browser version. 3446 </dd> 3447 3448 <!-- OBJECT PROPERTIES --> 3449 <dd style="display: none; "> 3450 <dl> 3451 <div> 3452 <div> 3453 </div> 3454 </div> 3455 </dl> 3456 </dd> 3457 3458 <!-- OBJECT METHODS --> 3459 <dd style="display: none; "> 3460 <div></div> 3461 </dd> 3462 3463 <!-- OBJECT EVENT FIELDS --> 3464 <dd style="display: none; "> 3465 <div></div> 3466 </dd> 3467 3468 <!-- FUNCTION PARAMETERS --> 3469 <dd style="display: none; "> 3470 <div></div> 3471 </dd> 3472 3473 </div> 3474 </div> 3475 </dl> 3476 3477 <!-- RETURNS --> 3478 <h4 style="display: none; ">Returns</h4> 3479 <dl> 3480 <div style="display: none; "> 3481 <div> 3482 </div> 3483 </div> 3484 </dl> 3485 3486 <!-- CALLBACK --> 3487 <div> 3488 <div> 3489 <h4>Callback function</h4> 3490 <p> 3491 The callback <em>parameter</em> should specify a function 3492 that looks like this: 3493 </p> 3494 <p style="display: none; "> 3495 If you specify the <em>callback</em> parameter, it should 3496 specify a function that looks like this: 3497 </p> 3498 3499 <!-- Note: intentionally longer 80 columns --> 3500 <pre>function(<span>Tab tab</span>) <span class="subdued">{...}</span>;</pre> 3501 <dl> 3502 <div> 3503 <div> 3504 <dt> 3505 <var>tab</var> 3506 <em> 3507 3508 <!-- TYPE --> 3509 <div style="display:inline"> 3510 ( 3511 <span class="optional" style="display: none; ">optional</span> 3512 <span class="enum" style="display: none; ">enumerated</span> 3513 <span id="typeTemplate"> 3514 <span> 3515 <a href="tabs.html#type-Tab">Tab</a> 3516 </span> 3517 <span style="display: none; "> 3518 <span> 3519 array of <span><span></span></span> 3520 </span> 3521 <span>paramType</span> 3522 <span></span> 3523 </span> 3524 </span> 3525 ) 3526 </div> 3527 3528 </em> 3529 </dt> 3530 <dd class="todo"> 3531 Undocumented. 3532 </dd> 3533 <dd style="display: none; "> 3534 Description of this parameter from the json schema. 3535 </dd> 3536 <dd style="display: none; "> 3537 This parameter was added in version 3538 <b><span></span></b>. 3539 You must omit this parameter in earlier versions, 3540 and you may omit it in any version. If you require this 3541 parameter, the manifest key 3542 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3543 can ensure that your extension won't be run in an earlier browser version. 3544 </dd> 3545 3546 <!-- OBJECT PROPERTIES --> 3547 <dd style="display: none; "> 3548 <dl> 3549 <div> 3550 <div> 3551 </div> 3552 </div> 3553 </dl> 3554 </dd> 3555 3556 <!-- OBJECT METHODS --> 3557 <dd style="display: none; "> 3558 <div></div> 3559 </dd> 3560 3561 <!-- OBJECT EVENT FIELDS --> 3562 <dd style="display: none; "> 3563 <div></div> 3564 </dd> 3565 3566 <!-- FUNCTION PARAMETERS --> 3567 <dd style="display: none; "> 3568 <div></div> 3569 </dd> 3570 3571 </div> 3572 </div> 3573 </dl> 3574 </div> 3575 </div> 3576 3577 <!-- MIN_VERSION --> 3578 <p style="display: none; "> 3579 This function was added in version <b><span></span></b>. 3580 If you require this function, the manifest key 3581 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3582 can ensure that your extension won't be run in an earlier browser version. 3583 </p> 3584 </div> <!-- /description --> 3585 3586 </div><div class="apiItem"> 3587 <a name="method-insertCSS"></a> <!-- method-anchor --> 3588 <h4>insertCSS</h4> 3589 3590 <div class="summary"><span style="display: none; ">void</span> 3591 <!-- Note: intentionally longer 80 columns --> 3592 <span>chrome.tabs.insertCSS</span>(<span class="optional"><span style="display: none; ">, </span><span>integer</span> 3593 <var><span>tabId</span></var></span><span class="null"><span>, </span><span>object</span> 3594 <var><span>details</span></var></span><span class="optional"><span>, </span><span>function</span> 3595 <var><span>callback</span></var></span>)</div> 3596 3597 <div class="description"> 3598 <p class="todo" style="display: none; ">Undocumented.</p> 3599 <p>Injects CSS into a page. For details, see the <a href="content_scripts.html#pi">programmatic injection</a> section of the content scripts doc.</p> 3600 3601 <!-- PARAMETERS --> 3602 <h4>Parameters</h4> 3603 <dl> 3604 <div> 3605 <div> 3606 <dt> 3607 <var>tabId</var> 3608 <em> 3609 3610 <!-- TYPE --> 3611 <div style="display:inline"> 3612 ( 3613 <span class="optional">optional</span> 3614 <span class="enum" style="display: none; ">enumerated</span> 3615 <span id="typeTemplate"> 3616 <span style="display: none; "> 3617 <a> Type</a> 3618 </span> 3619 <span> 3620 <span style="display: none; "> 3621 array of <span><span></span></span> 3622 </span> 3623 <span>integer</span> 3624 <span style="display: none; "></span> 3625 </span> 3626 </span> 3627 ) 3628 </div> 3629 3630 </em> 3631 </dt> 3632 <dd class="todo" style="display: none; "> 3633 Undocumented. 3634 </dd> 3635 <dd>The ID of the tab in which to insert the CSS; defaults to the selected tab of the current window.</dd> 3636 <dd style="display: none; "> 3637 This parameter was added in version 3638 <b><span></span></b>. 3639 You must omit this parameter in earlier versions, 3640 and you may omit it in any version. If you require this 3641 parameter, the manifest key 3642 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3643 can ensure that your extension won't be run in an earlier browser version. 3644 </dd> 3645 3646 <!-- OBJECT PROPERTIES --> 3647 <dd style="display: none; "> 3648 <dl> 3649 <div> 3650 <div> 3651 </div> 3652 </div> 3653 </dl> 3654 </dd> 3655 3656 <!-- OBJECT METHODS --> 3657 <dd style="display: none; "> 3658 <div></div> 3659 </dd> 3660 3661 <!-- OBJECT EVENT FIELDS --> 3662 <dd style="display: none; "> 3663 <div></div> 3664 </dd> 3665 3666 <!-- FUNCTION PARAMETERS --> 3667 <dd style="display: none; "> 3668 <div></div> 3669 </dd> 3670 3671 </div> 3672 </div><div> 3673 <div> 3674 <dt> 3675 <var>details</var> 3676 <em> 3677 3678 <!-- TYPE --> 3679 <div style="display:inline"> 3680 ( 3681 <span class="optional" style="display: none; ">optional</span> 3682 <span class="enum" style="display: none; ">enumerated</span> 3683 <span id="typeTemplate"> 3684 <span style="display: none; "> 3685 <a> Type</a> 3686 </span> 3687 <span> 3688 <span style="display: none; "> 3689 array of <span><span></span></span> 3690 </span> 3691 <span>object</span> 3692 <span style="display: none; "></span> 3693 </span> 3694 </span> 3695 ) 3696 </div> 3697 3698 </em> 3699 </dt> 3700 <dd class="todo" style="display: none; "> 3701 Undocumented. 3702 </dd> 3703 <dd>Details of the CSS text to insert. Either the code or the file property must be set, but both may not be set at the same time.</dd> 3704 <dd style="display: none; "> 3705 This parameter was added in version 3706 <b><span></span></b>. 3707 You must omit this parameter in earlier versions, 3708 and you may omit it in any version. If you require this 3709 parameter, the manifest key 3710 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3711 can ensure that your extension won't be run in an earlier browser version. 3712 </dd> 3713 3714 <!-- OBJECT PROPERTIES --> 3715 <dd> 3716 <dl> 3717 <div> 3718 <div> 3719 <dt> 3720 <var>code</var> 3721 <em> 3722 3723 <!-- TYPE --> 3724 <div style="display:inline"> 3725 ( 3726 <span class="optional">optional</span> 3727 <span class="enum" style="display: none; ">enumerated</span> 3728 <span id="typeTemplate"> 3729 <span style="display: none; "> 3730 <a> Type</a> 3731 </span> 3732 <span> 3733 <span style="display: none; "> 3734 array of <span><span></span></span> 3735 </span> 3736 <span>string</span> 3737 <span style="display: none; "></span> 3738 </span> 3739 </span> 3740 ) 3741 </div> 3742 3743 </em> 3744 </dt> 3745 <dd class="todo" style="display: none; "> 3746 Undocumented. 3747 </dd> 3748 <dd>CSS code to be injected.</dd> 3749 <dd style="display: none; "> 3750 This parameter was added in version 3751 <b><span></span></b>. 3752 You must omit this parameter in earlier versions, 3753 and you may omit it in any version. If you require this 3754 parameter, the manifest key 3755 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3756 can ensure that your extension won't be run in an earlier browser version. 3757 </dd> 3758 3759 <!-- OBJECT PROPERTIES --> 3760 <dd style="display: none; "> 3761 <dl> 3762 <div> 3763 <div> 3764 </div> 3765 </div> 3766 </dl> 3767 </dd> 3768 3769 <!-- OBJECT METHODS --> 3770 <dd style="display: none; "> 3771 <div></div> 3772 </dd> 3773 3774 <!-- OBJECT EVENT FIELDS --> 3775 <dd style="display: none; "> 3776 <div></div> 3777 </dd> 3778 3779 <!-- FUNCTION PARAMETERS --> 3780 <dd style="display: none; "> 3781 <div></div> 3782 </dd> 3783 3784 </div> 3785 </div><div> 3786 <div> 3787 <dt> 3788 <var>file</var> 3789 <em> 3790 3791 <!-- TYPE --> 3792 <div style="display:inline"> 3793 ( 3794 <span class="optional">optional</span> 3795 <span class="enum" style="display: none; ">enumerated</span> 3796 <span id="typeTemplate"> 3797 <span style="display: none; "> 3798 <a> Type</a> 3799 </span> 3800 <span> 3801 <span style="display: none; "> 3802 array of <span><span></span></span> 3803 </span> 3804 <span>string</span> 3805 <span style="display: none; "></span> 3806 </span> 3807 </span> 3808 ) 3809 </div> 3810 3811 </em> 3812 </dt> 3813 <dd class="todo" style="display: none; "> 3814 Undocumented. 3815 </dd> 3816 <dd>CSS file to be injected.</dd> 3817 <dd style="display: none; "> 3818 This parameter was added in version 3819 <b><span></span></b>. 3820 You must omit this parameter in earlier versions, 3821 and you may omit it in any version. If you require this 3822 parameter, the manifest key 3823 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3824 can ensure that your extension won't be run in an earlier browser version. 3825 </dd> 3826 3827 <!-- OBJECT PROPERTIES --> 3828 <dd style="display: none; "> 3829 <dl> 3830 <div> 3831 <div> 3832 </div> 3833 </div> 3834 </dl> 3835 </dd> 3836 3837 <!-- OBJECT METHODS --> 3838 <dd style="display: none; "> 3839 <div></div> 3840 </dd> 3841 3842 <!-- OBJECT EVENT FIELDS --> 3843 <dd style="display: none; "> 3844 <div></div> 3845 </dd> 3846 3847 <!-- FUNCTION PARAMETERS --> 3848 <dd style="display: none; "> 3849 <div></div> 3850 </dd> 3851 3852 </div> 3853 </div><div> 3854 <div> 3855 <dt> 3856 <var>allFrames</var> 3857 <em> 3858 3859 <!-- TYPE --> 3860 <div style="display:inline"> 3861 ( 3862 <span class="optional">optional</span> 3863 <span class="enum" style="display: none; ">enumerated</span> 3864 <span id="typeTemplate"> 3865 <span style="display: none; "> 3866 <a> Type</a> 3867 </span> 3868 <span> 3869 <span style="display: none; "> 3870 array of <span><span></span></span> 3871 </span> 3872 <span>boolean</span> 3873 <span style="display: none; "></span> 3874 </span> 3875 </span> 3876 ) 3877 </div> 3878 3879 </em> 3880 </dt> 3881 <dd class="todo" style="display: none; "> 3882 Undocumented. 3883 </dd> 3884 <dd>If allFrames is true, this function injects CSS text into all frames of current page. By default, it's false and CSS is injected only into the top main frame.</dd> 3885 <dd style="display: none; "> 3886 This parameter was added in version 3887 <b><span></span></b>. 3888 You must omit this parameter in earlier versions, 3889 and you may omit it in any version. If you require this 3890 parameter, the manifest key 3891 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3892 can ensure that your extension won't be run in an earlier browser version. 3893 </dd> 3894 3895 <!-- OBJECT PROPERTIES --> 3896 <dd style="display: none; "> 3897 <dl> 3898 <div> 3899 <div> 3900 </div> 3901 </div> 3902 </dl> 3903 </dd> 3904 3905 <!-- OBJECT METHODS --> 3906 <dd style="display: none; "> 3907 <div></div> 3908 </dd> 3909 3910 <!-- OBJECT EVENT FIELDS --> 3911 <dd style="display: none; "> 3912 <div></div> 3913 </dd> 3914 3915 <!-- FUNCTION PARAMETERS --> 3916 <dd style="display: none; "> 3917 <div></div> 3918 </dd> 3919 3920 </div> 3921 </div> 3922 </dl> 3923 </dd> 3924 3925 <!-- OBJECT METHODS --> 3926 <dd style="display: none; "> 3927 <div></div> 3928 </dd> 3929 3930 <!-- OBJECT EVENT FIELDS --> 3931 <dd style="display: none; "> 3932 <div></div> 3933 </dd> 3934 3935 <!-- FUNCTION PARAMETERS --> 3936 <dd style="display: none; "> 3937 <div></div> 3938 </dd> 3939 3940 </div> 3941 </div><div> 3942 <div> 3943 <dt> 3944 <var>callback</var> 3945 <em> 3946 3947 <!-- TYPE --> 3948 <div style="display:inline"> 3949 ( 3950 <span class="optional">optional</span> 3951 <span class="enum" style="display: none; ">enumerated</span> 3952 <span id="typeTemplate"> 3953 <span style="display: none; "> 3954 <a> Type</a> 3955 </span> 3956 <span> 3957 <span style="display: none; "> 3958 array of <span><span></span></span> 3959 </span> 3960 <span>function</span> 3961 <span style="display: none; "></span> 3962 </span> 3963 </span> 3964 ) 3965 </div> 3966 3967 </em> 3968 </dt> 3969 <dd class="todo" style="display: none; "> 3970 Undocumented. 3971 </dd> 3972 <dd>Called when all the CSS has been inserted.</dd> 3973 <dd style="display: none; "> 3974 This parameter was added in version 3975 <b><span></span></b>. 3976 You must omit this parameter in earlier versions, 3977 and you may omit it in any version. If you require this 3978 parameter, the manifest key 3979 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3980 can ensure that your extension won't be run in an earlier browser version. 3981 </dd> 3982 3983 <!-- OBJECT PROPERTIES --> 3984 <dd style="display: none; "> 3985 <dl> 3986 <div> 3987 <div> 3988 </div> 3989 </div> 3990 </dl> 3991 </dd> 3992 3993 <!-- OBJECT METHODS --> 3994 <dd style="display: none; "> 3995 <div></div> 3996 </dd> 3997 3998 <!-- OBJECT EVENT FIELDS --> 3999 <dd style="display: none; "> 4000 <div></div> 4001 </dd> 4002 4003 <!-- FUNCTION PARAMETERS --> 4004 <dd style="display: none; "> 4005 <div></div> 4006 </dd> 4007 4008 </div> 4009 </div> 4010 </dl> 4011 4012 <!-- RETURNS --> 4013 <h4 style="display: none; ">Returns</h4> 4014 <dl> 4015 <div style="display: none; "> 4016 <div> 4017 </div> 4018 </div> 4019 </dl> 4020 4021 <!-- CALLBACK --> 4022 <div> 4023 <div> 4024 <h4>Callback function</h4> 4025 <p style="display: none; "> 4026 The callback <em>parameter</em> should specify a function 4027 that looks like this: 4028 </p> 4029 <p> 4030 If you specify the <em>callback</em> parameter, it should 4031 specify a function that looks like this: 4032 </p> 4033 4034 <!-- Note: intentionally longer 80 columns --> 4035 <pre>function(<span></span>) <span class="subdued">{...}</span>;</pre> 4036 <dl> 4037 <div style="display: none; "> 4038 <div> 4039 </div> 4040 </div> 4041 </dl> 4042 </div> 4043 </div> 4044 4045 <!-- MIN_VERSION --> 4046 <p style="display: none; "> 4047 This function was added in version <b><span></span></b>. 4048 If you require this function, the manifest key 4049 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4050 can ensure that your extension won't be run in an earlier browser version. 4051 </p> 4052 </div> <!-- /description --> 4053 4054 </div><div class="apiItem"> 4055 <a name="method-move"></a> <!-- method-anchor --> 4056 <h4>move</h4> 4057 4058 <div class="summary"><span style="display: none; ">void</span> 4059 <!-- Note: intentionally longer 80 columns --> 4060 <span>chrome.tabs.move</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 4061 <var><span>tabId</span></var></span><span class="null"><span>, </span><span>object</span> 4062 <var><span>moveProperties</span></var></span><span class="optional"><span>, </span><span>function</span> 4063 <var><span>callback</span></var></span>)</div> 4064 4065 <div class="description"> 4066 <p class="todo" style="display: none; ">Undocumented.</p> 4067 <p>Moves a tab to a new position within its window, or to a new window. Note that tabs can only be moved to and from normal (window.type === "normal") windows.</p> 4068 4069 <!-- PARAMETERS --> 4070 <h4>Parameters</h4> 4071 <dl> 4072 <div> 4073 <div> 4074 <dt> 4075 <var>tabId</var> 4076 <em> 4077 4078 <!-- TYPE --> 4079 <div style="display:inline"> 4080 ( 4081 <span class="optional" style="display: none; ">optional</span> 4082 <span class="enum" style="display: none; ">enumerated</span> 4083 <span id="typeTemplate"> 4084 <span style="display: none; "> 4085 <a> Type</a> 4086 </span> 4087 <span> 4088 <span style="display: none; "> 4089 array of <span><span></span></span> 4090 </span> 4091 <span>integer</span> 4092 <span style="display: none; "></span> 4093 </span> 4094 </span> 4095 ) 4096 </div> 4097 4098 </em> 4099 </dt> 4100 <dd class="todo"> 4101 Undocumented. 4102 </dd> 4103 <dd style="display: none; "> 4104 Description of this parameter from the json schema. 4105 </dd> 4106 <dd style="display: none; "> 4107 This parameter was added in version 4108 <b><span></span></b>. 4109 You must omit this parameter in earlier versions, 4110 and you may omit it in any version. If you require this 4111 parameter, the manifest key 4112 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4113 can ensure that your extension won't be run in an earlier browser version. 4114 </dd> 4115 4116 <!-- OBJECT PROPERTIES --> 4117 <dd style="display: none; "> 4118 <dl> 4119 <div> 4120 <div> 4121 </div> 4122 </div> 4123 </dl> 4124 </dd> 4125 4126 <!-- OBJECT METHODS --> 4127 <dd style="display: none; "> 4128 <div></div> 4129 </dd> 4130 4131 <!-- OBJECT EVENT FIELDS --> 4132 <dd style="display: none; "> 4133 <div></div> 4134 </dd> 4135 4136 <!-- FUNCTION PARAMETERS --> 4137 <dd style="display: none; "> 4138 <div></div> 4139 </dd> 4140 4141 </div> 4142 </div><div> 4143 <div> 4144 <dt> 4145 <var>moveProperties</var> 4146 <em> 4147 4148 <!-- TYPE --> 4149 <div style="display:inline"> 4150 ( 4151 <span class="optional" style="display: none; ">optional</span> 4152 <span class="enum" style="display: none; ">enumerated</span> 4153 <span id="typeTemplate"> 4154 <span style="display: none; "> 4155 <a> Type</a> 4156 </span> 4157 <span> 4158 <span style="display: none; "> 4159 array of <span><span></span></span> 4160 </span> 4161 <span>object</span> 4162 <span style="display: none; "></span> 4163 </span> 4164 </span> 4165 ) 4166 </div> 4167 4168 </em> 4169 </dt> 4170 <dd class="todo"> 4171 Undocumented. 4172 </dd> 4173 <dd style="display: none; "> 4174 Description of this parameter from the json schema. 4175 </dd> 4176 <dd style="display: none; "> 4177 This parameter was added in version 4178 <b><span></span></b>. 4179 You must omit this parameter in earlier versions, 4180 and you may omit it in any version. If you require this 4181 parameter, the manifest key 4182 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4183 can ensure that your extension won't be run in an earlier browser version. 4184 </dd> 4185 4186 <!-- OBJECT PROPERTIES --> 4187 <dd> 4188 <dl> 4189 <div> 4190 <div> 4191 <dt> 4192 <var>windowId</var> 4193 <em> 4194 4195 <!-- TYPE --> 4196 <div style="display:inline"> 4197 ( 4198 <span class="optional">optional</span> 4199 <span class="enum" style="display: none; ">enumerated</span> 4200 <span id="typeTemplate"> 4201 <span style="display: none; "> 4202 <a> Type</a> 4203 </span> 4204 <span> 4205 <span style="display: none; "> 4206 array of <span><span></span></span> 4207 </span> 4208 <span>integer</span> 4209 <span style="display: none; "></span> 4210 </span> 4211 </span> 4212 ) 4213 </div> 4214 4215 </em> 4216 </dt> 4217 <dd class="todo" style="display: none; "> 4218 Undocumented. 4219 </dd> 4220 <dd>Defaults to the window the tab is currently in.</dd> 4221 <dd style="display: none; "> 4222 This parameter was added in version 4223 <b><span></span></b>. 4224 You must omit this parameter in earlier versions, 4225 and you may omit it in any version. If you require this 4226 parameter, the manifest key 4227 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4228 can ensure that your extension won't be run in an earlier browser version. 4229 </dd> 4230 4231 <!-- OBJECT PROPERTIES --> 4232 <dd style="display: none; "> 4233 <dl> 4234 <div> 4235 <div> 4236 </div> 4237 </div> 4238 </dl> 4239 </dd> 4240 4241 <!-- OBJECT METHODS --> 4242 <dd style="display: none; "> 4243 <div></div> 4244 </dd> 4245 4246 <!-- OBJECT EVENT FIELDS --> 4247 <dd style="display: none; "> 4248 <div></div> 4249 </dd> 4250 4251 <!-- FUNCTION PARAMETERS --> 4252 <dd style="display: none; "> 4253 <div></div> 4254 </dd> 4255 4256 </div> 4257 </div><div> 4258 <div> 4259 <dt> 4260 <var>index</var> 4261 <em> 4262 4263 <!-- TYPE --> 4264 <div style="display:inline"> 4265 ( 4266 <span class="optional" style="display: none; ">optional</span> 4267 <span class="enum" style="display: none; ">enumerated</span> 4268 <span id="typeTemplate"> 4269 <span style="display: none; "> 4270 <a> Type</a> 4271 </span> 4272 <span> 4273 <span style="display: none; "> 4274 array of <span><span></span></span> 4275 </span> 4276 <span>integer</span> 4277 <span style="display: none; "></span> 4278 </span> 4279 </span> 4280 ) 4281 </div> 4282 4283 </em> 4284 </dt> 4285 <dd class="todo" style="display: none; "> 4286 Undocumented. 4287 </dd> 4288 <dd>The position to move the window to. The provided value will be clamped to between zero and the number of tabs in the window.</dd> 4289 <dd style="display: none; "> 4290 This parameter was added in version 4291 <b><span></span></b>. 4292 You must omit this parameter in earlier versions, 4293 and you may omit it in any version. If you require this 4294 parameter, the manifest key 4295 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4296 can ensure that your extension won't be run in an earlier browser version. 4297 </dd> 4298 4299 <!-- OBJECT PROPERTIES --> 4300 <dd style="display: none; "> 4301 <dl> 4302 <div> 4303 <div> 4304 </div> 4305 </div> 4306 </dl> 4307 </dd> 4308 4309 <!-- OBJECT METHODS --> 4310 <dd style="display: none; "> 4311 <div></div> 4312 </dd> 4313 4314 <!-- OBJECT EVENT FIELDS --> 4315 <dd style="display: none; "> 4316 <div></div> 4317 </dd> 4318 4319 <!-- FUNCTION PARAMETERS --> 4320 <dd style="display: none; "> 4321 <div></div> 4322 </dd> 4323 4324 </div> 4325 </div> 4326 </dl> 4327 </dd> 4328 4329 <!-- OBJECT METHODS --> 4330 <dd style="display: none; "> 4331 <div></div> 4332 </dd> 4333 4334 <!-- OBJECT EVENT FIELDS --> 4335 <dd style="display: none; "> 4336 <div></div> 4337 </dd> 4338 4339 <!-- FUNCTION PARAMETERS --> 4340 <dd style="display: none; "> 4341 <div></div> 4342 </dd> 4343 4344 </div> 4345 </div><div> 4346 <div> 4347 <dt> 4348 <var>callback</var> 4349 <em> 4350 4351 <!-- TYPE --> 4352 <div style="display:inline"> 4353 ( 4354 <span class="optional">optional</span> 4355 <span class="enum" style="display: none; ">enumerated</span> 4356 <span id="typeTemplate"> 4357 <span style="display: none; "> 4358 <a> Type</a> 4359 </span> 4360 <span> 4361 <span style="display: none; "> 4362 array of <span><span></span></span> 4363 </span> 4364 <span>function</span> 4365 <span style="display: none; "></span> 4366 </span> 4367 </span> 4368 ) 4369 </div> 4370 4371 </em> 4372 </dt> 4373 <dd class="todo"> 4374 Undocumented. 4375 </dd> 4376 <dd style="display: none; "> 4377 Description of this parameter from the json schema. 4378 </dd> 4379 <dd style="display: none; "> 4380 This parameter was added in version 4381 <b><span></span></b>. 4382 You must omit this parameter in earlier versions, 4383 and you may omit it in any version. If you require this 4384 parameter, the manifest key 4385 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4386 can ensure that your extension won't be run in an earlier browser version. 4387 </dd> 4388 4389 <!-- OBJECT PROPERTIES --> 4390 <dd style="display: none; "> 4391 <dl> 4392 <div> 4393 <div> 4394 </div> 4395 </div> 4396 </dl> 4397 </dd> 4398 4399 <!-- OBJECT METHODS --> 4400 <dd style="display: none; "> 4401 <div></div> 4402 </dd> 4403 4404 <!-- OBJECT EVENT FIELDS --> 4405 <dd style="display: none; "> 4406 <div></div> 4407 </dd> 4408 4409 <!-- FUNCTION PARAMETERS --> 4410 <dd style="display: none; "> 4411 <div></div> 4412 </dd> 4413 4414 </div> 4415 </div> 4416 </dl> 4417 4418 <!-- RETURNS --> 4419 <h4 style="display: none; ">Returns</h4> 4420 <dl> 4421 <div style="display: none; "> 4422 <div> 4423 </div> 4424 </div> 4425 </dl> 4426 4427 <!-- CALLBACK --> 4428 <div> 4429 <div> 4430 <h4>Callback function</h4> 4431 <p style="display: none; "> 4432 The callback <em>parameter</em> should specify a function 4433 that looks like this: 4434 </p> 4435 <p> 4436 If you specify the <em>callback</em> parameter, it should 4437 specify a function that looks like this: 4438 </p> 4439 4440 <!-- Note: intentionally longer 80 columns --> 4441 <pre>function(<span>Tab tab</span>) <span class="subdued">{...}</span>;</pre> 4442 <dl> 4443 <div> 4444 <div> 4445 <dt> 4446 <var>tab</var> 4447 <em> 4448 4449 <!-- TYPE --> 4450 <div style="display:inline"> 4451 ( 4452 <span class="optional" style="display: none; ">optional</span> 4453 <span class="enum" style="display: none; ">enumerated</span> 4454 <span id="typeTemplate"> 4455 <span> 4456 <a href="tabs.html#type-Tab">Tab</a> 4457 </span> 4458 <span style="display: none; "> 4459 <span> 4460 array of <span><span></span></span> 4461 </span> 4462 <span>paramType</span> 4463 <span></span> 4464 </span> 4465 </span> 4466 ) 4467 </div> 4468 4469 </em> 4470 </dt> 4471 <dd class="todo" style="display: none; "> 4472 Undocumented. 4473 </dd> 4474 <dd>Details about the moved tab.</dd> 4475 <dd style="display: none; "> 4476 This parameter was added in version 4477 <b><span></span></b>. 4478 You must omit this parameter in earlier versions, 4479 and you may omit it in any version. If you require this 4480 parameter, the manifest key 4481 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4482 can ensure that your extension won't be run in an earlier browser version. 4483 </dd> 4484 4485 <!-- OBJECT PROPERTIES --> 4486 <dd style="display: none; "> 4487 <dl> 4488 <div> 4489 <div> 4490 </div> 4491 </div> 4492 </dl> 4493 </dd> 4494 4495 <!-- OBJECT METHODS --> 4496 <dd style="display: none; "> 4497 <div></div> 4498 </dd> 4499 4500 <!-- OBJECT EVENT FIELDS --> 4501 <dd style="display: none; "> 4502 <div></div> 4503 </dd> 4504 4505 <!-- FUNCTION PARAMETERS --> 4506 <dd style="display: none; "> 4507 <div></div> 4508 </dd> 4509 4510 </div> 4511 </div> 4512 </dl> 4513 </div> 4514 </div> 4515 4516 <!-- MIN_VERSION --> 4517 <p style="display: none; "> 4518 This function was added in version <b><span></span></b>. 4519 If you require this function, the manifest key 4520 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4521 can ensure that your extension won't be run in an earlier browser version. 4522 </p> 4523 </div> <!-- /description --> 4524 4525 </div><div class="apiItem"> 4526 <a name="method-remove"></a> <!-- method-anchor --> 4527 <h4>remove</h4> 4528 4529 <div class="summary"><span style="display: none; ">void</span> 4530 <!-- Note: intentionally longer 80 columns --> 4531 <span>chrome.tabs.remove</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 4532 <var><span>tabId</span></var></span><span class="optional"><span>, </span><span>function</span> 4533 <var><span>callback</span></var></span>)</div> 4534 4535 <div class="description"> 4536 <p class="todo" style="display: none; ">Undocumented.</p> 4537 <p>Closes a tab.</p> 4538 4539 <!-- PARAMETERS --> 4540 <h4>Parameters</h4> 4541 <dl> 4542 <div> 4543 <div> 4544 <dt> 4545 <var>tabId</var> 4546 <em> 4547 4548 <!-- TYPE --> 4549 <div style="display:inline"> 4550 ( 4551 <span class="optional" style="display: none; ">optional</span> 4552 <span class="enum" style="display: none; ">enumerated</span> 4553 <span id="typeTemplate"> 4554 <span style="display: none; "> 4555 <a> Type</a> 4556 </span> 4557 <span> 4558 <span style="display: none; "> 4559 array of <span><span></span></span> 4560 </span> 4561 <span>integer</span> 4562 <span style="display: none; "></span> 4563 </span> 4564 </span> 4565 ) 4566 </div> 4567 4568 </em> 4569 </dt> 4570 <dd class="todo"> 4571 Undocumented. 4572 </dd> 4573 <dd style="display: none; "> 4574 Description of this parameter from the json schema. 4575 </dd> 4576 <dd style="display: none; "> 4577 This parameter was added in version 4578 <b><span></span></b>. 4579 You must omit this parameter in earlier versions, 4580 and you may omit it in any version. If you require this 4581 parameter, the manifest key 4582 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4583 can ensure that your extension won't be run in an earlier browser version. 4584 </dd> 4585 4586 <!-- OBJECT PROPERTIES --> 4587 <dd style="display: none; "> 4588 <dl> 4589 <div> 4590 <div> 4591 </div> 4592 </div> 4593 </dl> 4594 </dd> 4595 4596 <!-- OBJECT METHODS --> 4597 <dd style="display: none; "> 4598 <div></div> 4599 </dd> 4600 4601 <!-- OBJECT EVENT FIELDS --> 4602 <dd style="display: none; "> 4603 <div></div> 4604 </dd> 4605 4606 <!-- FUNCTION PARAMETERS --> 4607 <dd style="display: none; "> 4608 <div></div> 4609 </dd> 4610 4611 </div> 4612 </div><div> 4613 <div> 4614 <dt> 4615 <var>callback</var> 4616 <em> 4617 4618 <!-- TYPE --> 4619 <div style="display:inline"> 4620 ( 4621 <span class="optional">optional</span> 4622 <span class="enum" style="display: none; ">enumerated</span> 4623 <span id="typeTemplate"> 4624 <span style="display: none; "> 4625 <a> Type</a> 4626 </span> 4627 <span> 4628 <span style="display: none; "> 4629 array of <span><span></span></span> 4630 </span> 4631 <span>function</span> 4632 <span style="display: none; "></span> 4633 </span> 4634 </span> 4635 ) 4636 </div> 4637 4638 </em> 4639 </dt> 4640 <dd class="todo"> 4641 Undocumented. 4642 </dd> 4643 <dd style="display: none; "> 4644 Description of this parameter from the json schema. 4645 </dd> 4646 <dd style="display: none; "> 4647 This parameter was added in version 4648 <b><span></span></b>. 4649 You must omit this parameter in earlier versions, 4650 and you may omit it in any version. If you require this 4651 parameter, the manifest key 4652 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4653 can ensure that your extension won't be run in an earlier browser version. 4654 </dd> 4655 4656 <!-- OBJECT PROPERTIES --> 4657 <dd style="display: none; "> 4658 <dl> 4659 <div> 4660 <div> 4661 </div> 4662 </div> 4663 </dl> 4664 </dd> 4665 4666 <!-- OBJECT METHODS --> 4667 <dd style="display: none; "> 4668 <div></div> 4669 </dd> 4670 4671 <!-- OBJECT EVENT FIELDS --> 4672 <dd style="display: none; "> 4673 <div></div> 4674 </dd> 4675 4676 <!-- FUNCTION PARAMETERS --> 4677 <dd style="display: none; "> 4678 <div></div> 4679 </dd> 4680 4681 </div> 4682 </div> 4683 </dl> 4684 4685 <!-- RETURNS --> 4686 <h4 style="display: none; ">Returns</h4> 4687 <dl> 4688 <div style="display: none; "> 4689 <div> 4690 </div> 4691 </div> 4692 </dl> 4693 4694 <!-- CALLBACK --> 4695 <div> 4696 <div> 4697 <h4>Callback function</h4> 4698 <p style="display: none; "> 4699 The callback <em>parameter</em> should specify a function 4700 that looks like this: 4701 </p> 4702 <p> 4703 If you specify the <em>callback</em> parameter, it should 4704 specify a function that looks like this: 4705 </p> 4706 4707 <!-- Note: intentionally longer 80 columns --> 4708 <pre>function(<span></span>) <span class="subdued">{...}</span>;</pre> 4709 <dl> 4710 <div style="display: none; "> 4711 <div> 4712 </div> 4713 </div> 4714 </dl> 4715 </div> 4716 </div> 4717 4718 <!-- MIN_VERSION --> 4719 <p style="display: none; "> 4720 This function was added in version <b><span></span></b>. 4721 If you require this function, the manifest key 4722 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4723 can ensure that your extension won't be run in an earlier browser version. 4724 </p> 4725 </div> <!-- /description --> 4726 4727 </div><div class="apiItem"> 4728 <a name="method-sendRequest"></a> <!-- method-anchor --> 4729 <h4>sendRequest</h4> 4730 4731 <div class="summary"><span style="display: none; ">void</span> 4732 <!-- Note: intentionally longer 80 columns --> 4733 <span>chrome.tabs.sendRequest</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 4734 <var><span>tabId</span></var></span><span class="null"><span>, </span><span>any</span> 4735 <var><span>request</span></var></span><span class="optional"><span>, </span><span>function</span> 4736 <var><span>responseCallback</span></var></span>)</div> 4737 4738 <div class="description"> 4739 <p class="todo" style="display: none; ">Undocumented.</p> 4740 <p>Sends a single request to the content script(s) in the specified tab, with an optional callback to run when a response is sent back. The <a href="extension.html#event-onRequest">chrome.extension.onRequest</a> event is fired in each content script running in the specified tab for the current extension.</p> 4741 4742 <!-- PARAMETERS --> 4743 <h4>Parameters</h4> 4744 <dl> 4745 <div> 4746 <div> 4747 <dt> 4748 <var>tabId</var> 4749 <em> 4750 4751 <!-- TYPE --> 4752 <div style="display:inline"> 4753 ( 4754 <span class="optional" style="display: none; ">optional</span> 4755 <span class="enum" style="display: none; ">enumerated</span> 4756 <span id="typeTemplate"> 4757 <span style="display: none; "> 4758 <a> Type</a> 4759 </span> 4760 <span> 4761 <span style="display: none; "> 4762 array of <span><span></span></span> 4763 </span> 4764 <span>integer</span> 4765 <span style="display: none; "></span> 4766 </span> 4767 </span> 4768 ) 4769 </div> 4770 4771 </em> 4772 </dt> 4773 <dd class="todo"> 4774 Undocumented. 4775 </dd> 4776 <dd style="display: none; "> 4777 Description of this parameter from the json schema. 4778 </dd> 4779 <dd style="display: none; "> 4780 This parameter was added in version 4781 <b><span></span></b>. 4782 You must omit this parameter in earlier versions, 4783 and you may omit it in any version. If you require this 4784 parameter, the manifest key 4785 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4786 can ensure that your extension won't be run in an earlier browser version. 4787 </dd> 4788 4789 <!-- OBJECT PROPERTIES --> 4790 <dd style="display: none; "> 4791 <dl> 4792 <div> 4793 <div> 4794 </div> 4795 </div> 4796 </dl> 4797 </dd> 4798 4799 <!-- OBJECT METHODS --> 4800 <dd style="display: none; "> 4801 <div></div> 4802 </dd> 4803 4804 <!-- OBJECT EVENT FIELDS --> 4805 <dd style="display: none; "> 4806 <div></div> 4807 </dd> 4808 4809 <!-- FUNCTION PARAMETERS --> 4810 <dd style="display: none; "> 4811 <div></div> 4812 </dd> 4813 4814 </div> 4815 </div><div> 4816 <div> 4817 <dt> 4818 <var>request</var> 4819 <em> 4820 4821 <!-- TYPE --> 4822 <div style="display:inline"> 4823 ( 4824 <span class="optional" style="display: none; ">optional</span> 4825 <span class="enum" style="display: none; ">enumerated</span> 4826 <span id="typeTemplate"> 4827 <span style="display: none; "> 4828 <a> Type</a> 4829 </span> 4830 <span> 4831 <span style="display: none; "> 4832 array of <span><span></span></span> 4833 </span> 4834 <span>any</span> 4835 <span style="display: none; "></span> 4836 </span> 4837 </span> 4838 ) 4839 </div> 4840 4841 </em> 4842 </dt> 4843 <dd class="todo"> 4844 Undocumented. 4845 </dd> 4846 <dd style="display: none; "> 4847 Description of this parameter from the json schema. 4848 </dd> 4849 <dd style="display: none; "> 4850 This parameter was added in version 4851 <b><span></span></b>. 4852 You must omit this parameter in earlier versions, 4853 and you may omit it in any version. If you require this 4854 parameter, the manifest key 4855 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4856 can ensure that your extension won't be run in an earlier browser version. 4857 </dd> 4858 4859 <!-- OBJECT PROPERTIES --> 4860 <dd style="display: none; "> 4861 <dl> 4862 <div> 4863 <div> 4864 </div> 4865 </div> 4866 </dl> 4867 </dd> 4868 4869 <!-- OBJECT METHODS --> 4870 <dd style="display: none; "> 4871 <div></div> 4872 </dd> 4873 4874 <!-- OBJECT EVENT FIELDS --> 4875 <dd style="display: none; "> 4876 <div></div> 4877 </dd> 4878 4879 <!-- FUNCTION PARAMETERS --> 4880 <dd style="display: none; "> 4881 <div></div> 4882 </dd> 4883 4884 </div> 4885 </div><div> 4886 <div> 4887 <dt> 4888 <var>responseCallback</var> 4889 <em> 4890 4891 <!-- TYPE --> 4892 <div style="display:inline"> 4893 ( 4894 <span class="optional">optional</span> 4895 <span class="enum" style="display: none; ">enumerated</span> 4896 <span id="typeTemplate"> 4897 <span style="display: none; "> 4898 <a> Type</a> 4899 </span> 4900 <span> 4901 <span style="display: none; "> 4902 array of <span><span></span></span> 4903 </span> 4904 <span>function</span> 4905 <span style="display: none; "></span> 4906 </span> 4907 </span> 4908 ) 4909 </div> 4910 4911 </em> 4912 </dt> 4913 <dd class="todo"> 4914 Undocumented. 4915 </dd> 4916 <dd style="display: none; "> 4917 Description of this parameter from the json schema. 4918 </dd> 4919 <dd style="display: none; "> 4920 This parameter was added in version 4921 <b><span></span></b>. 4922 You must omit this parameter in earlier versions, 4923 and you may omit it in any version. If you require this 4924 parameter, the manifest key 4925 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4926 can ensure that your extension won't be run in an earlier browser version. 4927 </dd> 4928 4929 <!-- OBJECT PROPERTIES --> 4930 <dd style="display: none; "> 4931 <dl> 4932 <div> 4933 <div> 4934 </div> 4935 </div> 4936 </dl> 4937 </dd> 4938 4939 <!-- OBJECT METHODS --> 4940 <dd style="display: none; "> 4941 <div></div> 4942 </dd> 4943 4944 <!-- OBJECT EVENT FIELDS --> 4945 <dd style="display: none; "> 4946 <div></div> 4947 </dd> 4948 4949 <!-- FUNCTION PARAMETERS --> 4950 <dd> 4951 <div> 4952 <h5>Parameters</h5> 4953 <dl> 4954 <div> 4955 <div> 4956 <dt> 4957 <var>response</var> 4958 <em> 4959 4960 <!-- TYPE --> 4961 <div style="display:inline"> 4962 ( 4963 <span class="optional" style="display: none; ">optional</span> 4964 <span class="enum" style="display: none; ">enumerated</span> 4965 <span id="typeTemplate"> 4966 <span style="display: none; "> 4967 <a> Type</a> 4968 </span> 4969 <span> 4970 <span style="display: none; "> 4971 array of <span><span></span></span> 4972 </span> 4973 <span>any</span> 4974 <span style="display: none; "></span> 4975 </span> 4976 </span> 4977 ) 4978 </div> 4979 4980 </em> 4981 </dt> 4982 <dd class="todo" style="display: none; "> 4983 Undocumented. 4984 </dd> 4985 <dd>The JSON response object sent by the handler of the request. If an error occurs while connecting to the specified tab, the callback will be called with no arguments and <a href="extension.html#property-lastError">chrome.extension.lastError</a> will be set to the error message.</dd> 4986 <dd style="display: none; "> 4987 This parameter was added in version 4988 <b><span></span></b>. 4989 You must omit this parameter in earlier versions, 4990 and you may omit it in any version. If you require this 4991 parameter, the manifest key 4992 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4993 can ensure that your extension won't be run in an earlier browser version. 4994 </dd> 4995 4996 <!-- OBJECT PROPERTIES --> 4997 <dd style="display: none; "> 4998 <dl> 4999 <div> 5000 <div> 5001 </div> 5002 </div> 5003 </dl> 5004 </dd> 5005 5006 <!-- OBJECT METHODS --> 5007 <dd style="display: none; "> 5008 <div></div> 5009 </dd> 5010 5011 <!-- OBJECT EVENT FIELDS --> 5012 <dd style="display: none; "> 5013 <div></div> 5014 </dd> 5015 5016 <!-- FUNCTION PARAMETERS --> 5017 <dd style="display: none; "> 5018 <div></div> 5019 </dd> 5020 5021 </div> 5022 </div> 5023 </dl> 5024 </div> 5025 </dd> 5026 5027 </div> 5028 </div> 5029 </dl> 5030 5031 <!-- RETURNS --> 5032 <h4 style="display: none; ">Returns</h4> 5033 <dl> 5034 <div style="display: none; "> 5035 <div> 5036 </div> 5037 </div> 5038 </dl> 5039 5040 <!-- CALLBACK --> 5041 <div> 5042 <div> 5043 <h4>Callback function</h4> 5044 <p style="display: none; "> 5045 The callback <em>parameter</em> should specify a function 5046 that looks like this: 5047 </p> 5048 <p> 5049 If you specify the <em>callback</em> parameter, it should 5050 specify a function that looks like this: 5051 </p> 5052 5053 <!-- Note: intentionally longer 80 columns --> 5054 <pre>function(<span>any response</span>) <span class="subdued">{...}</span>;</pre> 5055 <dl> 5056 <div> 5057 <div> 5058 <dt> 5059 <var>response</var> 5060 <em> 5061 5062 <!-- TYPE --> 5063 <div style="display:inline"> 5064 ( 5065 <span class="optional" style="display: none; ">optional</span> 5066 <span class="enum" style="display: none; ">enumerated</span> 5067 <span id="typeTemplate"> 5068 <span style="display: none; "> 5069 <a> Type</a> 5070 </span> 5071 <span> 5072 <span style="display: none; "> 5073 array of <span><span></span></span> 5074 </span> 5075 <span>any</span> 5076 <span style="display: none; "></span> 5077 </span> 5078 </span> 5079 ) 5080 </div> 5081 5082 </em> 5083 </dt> 5084 <dd class="todo" style="display: none; "> 5085 Undocumented. 5086 </dd> 5087 <dd>The JSON response object sent by the handler of the request. If an error occurs while connecting to the specified tab, the callback will be called with no arguments and <a href="extension.html#property-lastError">chrome.extension.lastError</a> will be set to the error message.</dd> 5088 <dd style="display: none; "> 5089 This parameter was added in version 5090 <b><span></span></b>. 5091 You must omit this parameter in earlier versions, 5092 and you may omit it in any version. If you require this 5093 parameter, the manifest key 5094 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5095 can ensure that your extension won't be run in an earlier browser version. 5096 </dd> 5097 5098 <!-- OBJECT PROPERTIES --> 5099 <dd style="display: none; "> 5100 <dl> 5101 <div> 5102 <div> 5103 </div> 5104 </div> 5105 </dl> 5106 </dd> 5107 5108 <!-- OBJECT METHODS --> 5109 <dd style="display: none; "> 5110 <div></div> 5111 </dd> 5112 5113 <!-- OBJECT EVENT FIELDS --> 5114 <dd style="display: none; "> 5115 <div></div> 5116 </dd> 5117 5118 <!-- FUNCTION PARAMETERS --> 5119 <dd style="display: none; "> 5120 <div></div> 5121 </dd> 5122 5123 </div> 5124 </div> 5125 </dl> 5126 </div> 5127 </div> 5128 5129 <!-- MIN_VERSION --> 5130 <p style="display: none; "> 5131 This function was added in version <b><span></span></b>. 5132 If you require this function, the manifest key 5133 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5134 can ensure that your extension won't be run in an earlier browser version. 5135 </p> 5136 </div> <!-- /description --> 5137 5138 </div><div class="apiItem"> 5139 <a name="method-update"></a> <!-- method-anchor --> 5140 <h4>update</h4> 5141 5142 <div class="summary"><span style="display: none; ">void</span> 5143 <!-- Note: intentionally longer 80 columns --> 5144 <span>chrome.tabs.update</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 5145 <var><span>tabId</span></var></span><span class="null"><span>, </span><span>object</span> 5146 <var><span>updateProperties</span></var></span><span class="optional"><span>, </span><span>function</span> 5147 <var><span>callback</span></var></span>)</div> 5148 5149 <div class="description"> 5150 <p class="todo" style="display: none; ">Undocumented.</p> 5151 <p>Modifies the properties of a tab. Properties that are not specified in <var>updateProperties</var> are not modified. Note: This function can be used without requesting the 'tabs' permission in the manifest.</p> 5152 5153 <!-- PARAMETERS --> 5154 <h4>Parameters</h4> 5155 <dl> 5156 <div> 5157 <div> 5158 <dt> 5159 <var>tabId</var> 5160 <em> 5161 5162 <!-- TYPE --> 5163 <div style="display:inline"> 5164 ( 5165 <span class="optional" style="display: none; ">optional</span> 5166 <span class="enum" style="display: none; ">enumerated</span> 5167 <span id="typeTemplate"> 5168 <span style="display: none; "> 5169 <a> Type</a> 5170 </span> 5171 <span> 5172 <span style="display: none; "> 5173 array of <span><span></span></span> 5174 </span> 5175 <span>integer</span> 5176 <span style="display: none; "></span> 5177 </span> 5178 </span> 5179 ) 5180 </div> 5181 5182 </em> 5183 </dt> 5184 <dd class="todo"> 5185 Undocumented. 5186 </dd> 5187 <dd style="display: none; "> 5188 Description of this parameter from the json schema. 5189 </dd> 5190 <dd style="display: none; "> 5191 This parameter was added in version 5192 <b><span></span></b>. 5193 You must omit this parameter in earlier versions, 5194 and you may omit it in any version. If you require this 5195 parameter, the manifest key 5196 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5197 can ensure that your extension won't be run in an earlier browser version. 5198 </dd> 5199 5200 <!-- OBJECT PROPERTIES --> 5201 <dd style="display: none; "> 5202 <dl> 5203 <div> 5204 <div> 5205 </div> 5206 </div> 5207 </dl> 5208 </dd> 5209 5210 <!-- OBJECT METHODS --> 5211 <dd style="display: none; "> 5212 <div></div> 5213 </dd> 5214 5215 <!-- OBJECT EVENT FIELDS --> 5216 <dd style="display: none; "> 5217 <div></div> 5218 </dd> 5219 5220 <!-- FUNCTION PARAMETERS --> 5221 <dd style="display: none; "> 5222 <div></div> 5223 </dd> 5224 5225 </div> 5226 </div><div> 5227 <div> 5228 <dt> 5229 <var>updateProperties</var> 5230 <em> 5231 5232 <!-- TYPE --> 5233 <div style="display:inline"> 5234 ( 5235 <span class="optional" style="display: none; ">optional</span> 5236 <span class="enum" style="display: none; ">enumerated</span> 5237 <span id="typeTemplate"> 5238 <span style="display: none; "> 5239 <a> Type</a> 5240 </span> 5241 <span> 5242 <span style="display: none; "> 5243 array of <span><span></span></span> 5244 </span> 5245 <span>object</span> 5246 <span style="display: none; "></span> 5247 </span> 5248 </span> 5249 ) 5250 </div> 5251 5252 </em> 5253 </dt> 5254 <dd class="todo"> 5255 Undocumented. 5256 </dd> 5257 <dd style="display: none; "> 5258 Description of this parameter from the json schema. 5259 </dd> 5260 <dd style="display: none; "> 5261 This parameter was added in version 5262 <b><span></span></b>. 5263 You must omit this parameter in earlier versions, 5264 and you may omit it in any version. If you require this 5265 parameter, the manifest key 5266 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5267 can ensure that your extension won't be run in an earlier browser version. 5268 </dd> 5269 5270 <!-- OBJECT PROPERTIES --> 5271 <dd> 5272 <dl> 5273 <div> 5274 <div> 5275 <dt> 5276 <var>url</var> 5277 <em> 5278 5279 <!-- TYPE --> 5280 <div style="display:inline"> 5281 ( 5282 <span class="optional">optional</span> 5283 <span class="enum" style="display: none; ">enumerated</span> 5284 <span id="typeTemplate"> 5285 <span style="display: none; "> 5286 <a> Type</a> 5287 </span> 5288 <span> 5289 <span style="display: none; "> 5290 array of <span><span></span></span> 5291 </span> 5292 <span>undefined</span> 5293 <span style="display: none; "></span> 5294 </span> 5295 </span> 5296 ) 5297 </div> 5298 5299 </em> 5300 </dt> 5301 <dd class="todo" style="display: none; "> 5302 Undocumented. 5303 </dd> 5304 <dd>A URL to navigate the tab to.</dd> 5305 <dd style="display: none; "> 5306 This parameter was added in version 5307 <b><span></span></b>. 5308 You must omit this parameter in earlier versions, 5309 and you may omit it in any version. If you require this 5310 parameter, the manifest key 5311 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5312 can ensure that your extension won't be run in an earlier browser version. 5313 </dd> 5314 5315 <!-- OBJECT PROPERTIES --> 5316 <dd style="display: none; "> 5317 <dl> 5318 <div> 5319 <div> 5320 </div> 5321 </div> 5322 </dl> 5323 </dd> 5324 5325 <!-- OBJECT METHODS --> 5326 <dd style="display: none; "> 5327 <div></div> 5328 </dd> 5329 5330 <!-- OBJECT EVENT FIELDS --> 5331 <dd style="display: none; "> 5332 <div></div> 5333 </dd> 5334 5335 <!-- FUNCTION PARAMETERS --> 5336 <dd style="display: none; "> 5337 <div></div> 5338 </dd> 5339 5340 </div> 5341 </div><div> 5342 <div> 5343 <dt> 5344 <var>selected</var> 5345 <em> 5346 5347 <!-- TYPE --> 5348 <div style="display:inline"> 5349 ( 5350 <span class="optional">optional</span> 5351 <span class="enum" style="display: none; ">enumerated</span> 5352 <span id="typeTemplate"> 5353 <span style="display: none; "> 5354 <a> Type</a> 5355 </span> 5356 <span> 5357 <span style="display: none; "> 5358 array of <span><span></span></span> 5359 </span> 5360 <span>boolean</span> 5361 <span style="display: none; "></span> 5362 </span> 5363 </span> 5364 ) 5365 </div> 5366 5367 </em> 5368 </dt> 5369 <dd class="todo" style="display: none; "> 5370 Undocumented. 5371 </dd> 5372 <dd>Whether the tab should be selected.</dd> 5373 <dd style="display: none; "> 5374 This parameter was added in version 5375 <b><span></span></b>. 5376 You must omit this parameter in earlier versions, 5377 and you may omit it in any version. If you require this 5378 parameter, the manifest key 5379 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5380 can ensure that your extension won't be run in an earlier browser version. 5381 </dd> 5382 5383 <!-- OBJECT PROPERTIES --> 5384 <dd style="display: none; "> 5385 <dl> 5386 <div> 5387 <div> 5388 </div> 5389 </div> 5390 </dl> 5391 </dd> 5392 5393 <!-- OBJECT METHODS --> 5394 <dd style="display: none; "> 5395 <div></div> 5396 </dd> 5397 5398 <!-- OBJECT EVENT FIELDS --> 5399 <dd style="display: none; "> 5400 <div></div> 5401 </dd> 5402 5403 <!-- FUNCTION PARAMETERS --> 5404 <dd style="display: none; "> 5405 <div></div> 5406 </dd> 5407 5408 </div> 5409 </div><div> 5410 <div> 5411 <dt> 5412 <var>pinned</var> 5413 <em> 5414 5415 <!-- TYPE --> 5416 <div style="display:inline"> 5417 ( 5418 <span class="optional">optional</span> 5419 <span class="enum" style="display: none; ">enumerated</span> 5420 <span id="typeTemplate"> 5421 <span style="display: none; "> 5422 <a> Type</a> 5423 </span> 5424 <span> 5425 <span style="display: none; "> 5426 array of <span><span></span></span> 5427 </span> 5428 <span>boolean</span> 5429 <span style="display: none; "></span> 5430 </span> 5431 </span> 5432 ) 5433 </div> 5434 5435 </em> 5436 </dt> 5437 <dd class="todo" style="display: none; "> 5438 Undocumented. 5439 </dd> 5440 <dd>Whether the tab should be pinned.</dd> 5441 <dd style="display: none; "> 5442 This parameter was added in version 5443 <b><span></span></b>. 5444 You must omit this parameter in earlier versions, 5445 and you may omit it in any version. If you require this 5446 parameter, the manifest key 5447 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5448 can ensure that your extension won't be run in an earlier browser version. 5449 </dd> 5450 5451 <!-- OBJECT PROPERTIES --> 5452 <dd style="display: none; "> 5453 <dl> 5454 <div> 5455 <div> 5456 </div> 5457 </div> 5458 </dl> 5459 </dd> 5460 5461 <!-- OBJECT METHODS --> 5462 <dd style="display: none; "> 5463 <div></div> 5464 </dd> 5465 5466 <!-- OBJECT EVENT FIELDS --> 5467 <dd style="display: none; "> 5468 <div></div> 5469 </dd> 5470 5471 <!-- FUNCTION PARAMETERS --> 5472 <dd style="display: none; "> 5473 <div></div> 5474 </dd> 5475 5476 </div> 5477 </div> 5478 </dl> 5479 </dd> 5480 5481 <!-- OBJECT METHODS --> 5482 <dd style="display: none; "> 5483 <div></div> 5484 </dd> 5485 5486 <!-- OBJECT EVENT FIELDS --> 5487 <dd style="display: none; "> 5488 <div></div> 5489 </dd> 5490 5491 <!-- FUNCTION PARAMETERS --> 5492 <dd style="display: none; "> 5493 <div></div> 5494 </dd> 5495 5496 </div> 5497 </div><div> 5498 <div> 5499 <dt> 5500 <var>callback</var> 5501 <em> 5502 5503 <!-- TYPE --> 5504 <div style="display:inline"> 5505 ( 5506 <span class="optional">optional</span> 5507 <span class="enum" style="display: none; ">enumerated</span> 5508 <span id="typeTemplate"> 5509 <span style="display: none; "> 5510 <a> Type</a> 5511 </span> 5512 <span> 5513 <span style="display: none; "> 5514 array of <span><span></span></span> 5515 </span> 5516 <span>function</span> 5517 <span style="display: none; "></span> 5518 </span> 5519 </span> 5520 ) 5521 </div> 5522 5523 </em> 5524 </dt> 5525 <dd class="todo"> 5526 Undocumented. 5527 </dd> 5528 <dd style="display: none; "> 5529 Description of this parameter from the json schema. 5530 </dd> 5531 <dd style="display: none; "> 5532 This parameter was added in version 5533 <b><span></span></b>. 5534 You must omit this parameter in earlier versions, 5535 and you may omit it in any version. If you require this 5536 parameter, the manifest key 5537 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5538 can ensure that your extension won't be run in an earlier browser version. 5539 </dd> 5540 5541 <!-- OBJECT PROPERTIES --> 5542 <dd style="display: none; "> 5543 <dl> 5544 <div> 5545 <div> 5546 </div> 5547 </div> 5548 </dl> 5549 </dd> 5550 5551 <!-- OBJECT METHODS --> 5552 <dd style="display: none; "> 5553 <div></div> 5554 </dd> 5555 5556 <!-- OBJECT EVENT FIELDS --> 5557 <dd style="display: none; "> 5558 <div></div> 5559 </dd> 5560 5561 <!-- FUNCTION PARAMETERS --> 5562 <dd style="display: none; "> 5563 <div></div> 5564 </dd> 5565 5566 </div> 5567 </div> 5568 </dl> 5569 5570 <!-- RETURNS --> 5571 <h4 style="display: none; ">Returns</h4> 5572 <dl> 5573 <div style="display: none; "> 5574 <div> 5575 </div> 5576 </div> 5577 </dl> 5578 5579 <!-- CALLBACK --> 5580 <div> 5581 <div> 5582 <h4>Callback function</h4> 5583 <p style="display: none; "> 5584 The callback <em>parameter</em> should specify a function 5585 that looks like this: 5586 </p> 5587 <p> 5588 If you specify the <em>callback</em> parameter, it should 5589 specify a function that looks like this: 5590 </p> 5591 5592 <!-- Note: intentionally longer 80 columns --> 5593 <pre>function(<span>Tab tab</span>) <span class="subdued">{...}</span>;</pre> 5594 <dl> 5595 <div> 5596 <div> 5597 <dt> 5598 <var>tab</var> 5599 <em> 5600 5601 <!-- TYPE --> 5602 <div style="display:inline"> 5603 ( 5604 <span class="optional" style="display: none; ">optional</span> 5605 <span class="enum" style="display: none; ">enumerated</span> 5606 <span id="typeTemplate"> 5607 <span> 5608 <a href="tabs.html#type-Tab">Tab</a> 5609 </span> 5610 <span style="display: none; "> 5611 <span> 5612 array of <span><span></span></span> 5613 </span> 5614 <span>paramType</span> 5615 <span></span> 5616 </span> 5617 </span> 5618 ) 5619 </div> 5620 5621 </em> 5622 </dt> 5623 <dd class="todo" style="display: none; "> 5624 Undocumented. 5625 </dd> 5626 <dd>Details about the updated tab.</dd> 5627 <dd style="display: none; "> 5628 This parameter was added in version 5629 <b><span></span></b>. 5630 You must omit this parameter in earlier versions, 5631 and you may omit it in any version. If you require this 5632 parameter, the manifest key 5633 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5634 can ensure that your extension won't be run in an earlier browser version. 5635 </dd> 5636 5637 <!-- OBJECT PROPERTIES --> 5638 <dd style="display: none; "> 5639 <dl> 5640 <div> 5641 <div> 5642 </div> 5643 </div> 5644 </dl> 5645 </dd> 5646 5647 <!-- OBJECT METHODS --> 5648 <dd style="display: none; "> 5649 <div></div> 5650 </dd> 5651 5652 <!-- OBJECT EVENT FIELDS --> 5653 <dd style="display: none; "> 5654 <div></div> 5655 </dd> 5656 5657 <!-- FUNCTION PARAMETERS --> 5658 <dd style="display: none; "> 5659 <div></div> 5660 </dd> 5661 5662 </div> 5663 </div> 5664 </dl> 5665 </div> 5666 </div> 5667 5668 <!-- MIN_VERSION --> 5669 <p style="display: none; "> 5670 This function was added in version <b><span></span></b>. 5671 If you require this function, the manifest key 5672 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5673 can ensure that your extension won't be run in an earlier browser version. 5674 </p> 5675 </div> <!-- /description --> 5676 5677 </div> <!-- /apiItem --> 5678 5679 </div> <!-- /apiGroup --> 5680 5681 <!-- EVENTS --> 5682 <div id="eventsTemplate" class="apiGroup"> 5683 <a name="global-events"></a> 5684 <h3>Events</h3> 5685 <!-- iterates over all events --> 5686 <div class="apiItem"> 5687 <a name="event-onAttached"></a> 5688 <h4>onAttached</h4> 5689 5690 <div class="summary"> 5691 <!-- Note: intentionally longer 80 columns --> 5692 <span class="subdued">chrome.tabs.</span><span>onAttached</span><span class="subdued">.addListener</span>(function(<span>integer tabId, object attachInfo</span>) <span class="subdued">{...}</span>); 5693 </div> 5694 5695 <div class="description"> 5696 <p class="todo" style="display: none; ">Undocumented.</p> 5697 <p>Fired when a tab is attached to a window, for example because it was moved between windows.</p> 5698 5699 <!-- PARAMETERS --> 5700 <div> 5701 <h4>Parameters</h4> 5702 <dl> 5703 <div> 5704 <div> 5705 <dt> 5706 <var>tabId</var> 5707 <em> 5708 5709 <!-- TYPE --> 5710 <div style="display:inline"> 5711 ( 5712 <span class="optional" style="display: none; ">optional</span> 5713 <span class="enum" style="display: none; ">enumerated</span> 5714 <span id="typeTemplate"> 5715 <span style="display: none; "> 5716 <a> Type</a> 5717 </span> 5718 <span> 5719 <span style="display: none; "> 5720 array of <span><span></span></span> 5721 </span> 5722 <span>integer</span> 5723 <span style="display: none; "></span> 5724 </span> 5725 </span> 5726 ) 5727 </div> 5728 5729 </em> 5730 </dt> 5731 <dd class="todo"> 5732 Undocumented. 5733 </dd> 5734 <dd style="display: none; "> 5735 Description of this parameter from the json schema. 5736 </dd> 5737 <dd style="display: none; "> 5738 This parameter was added in version 5739 <b><span></span></b>. 5740 You must omit this parameter in earlier versions, 5741 and you may omit it in any version. If you require this 5742 parameter, the manifest key 5743 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5744 can ensure that your extension won't be run in an earlier browser version. 5745 </dd> 5746 5747 <!-- OBJECT PROPERTIES --> 5748 <dd style="display: none; "> 5749 <dl> 5750 <div> 5751 <div> 5752 </div> 5753 </div> 5754 </dl> 5755 </dd> 5756 5757 <!-- OBJECT METHODS --> 5758 <dd style="display: none; "> 5759 <div></div> 5760 </dd> 5761 5762 <!-- OBJECT EVENT FIELDS --> 5763 <dd style="display: none; "> 5764 <div></div> 5765 </dd> 5766 5767 <!-- FUNCTION PARAMETERS --> 5768 <dd style="display: none; "> 5769 <div></div> 5770 </dd> 5771 5772 </div> 5773 </div><div> 5774 <div> 5775 <dt> 5776 <var>attachInfo</var> 5777 <em> 5778 5779 <!-- TYPE --> 5780 <div style="display:inline"> 5781 ( 5782 <span class="optional" style="display: none; ">optional</span> 5783 <span class="enum" style="display: none; ">enumerated</span> 5784 <span id="typeTemplate"> 5785 <span style="display: none; "> 5786 <a> Type</a> 5787 </span> 5788 <span> 5789 <span style="display: none; "> 5790 array of <span><span></span></span> 5791 </span> 5792 <span>object</span> 5793 <span style="display: none; "></span> 5794 </span> 5795 </span> 5796 ) 5797 </div> 5798 5799 </em> 5800 </dt> 5801 <dd class="todo"> 5802 Undocumented. 5803 </dd> 5804 <dd style="display: none; "> 5805 Description of this parameter from the json schema. 5806 </dd> 5807 <dd style="display: none; "> 5808 This parameter was added in version 5809 <b><span></span></b>. 5810 You must omit this parameter in earlier versions, 5811 and you may omit it in any version. If you require this 5812 parameter, the manifest key 5813 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5814 can ensure that your extension won't be run in an earlier browser version. 5815 </dd> 5816 5817 <!-- OBJECT PROPERTIES --> 5818 <dd> 5819 <dl> 5820 <div> 5821 <div> 5822 <dt> 5823 <var>newWindowId</var> 5824 <em> 5825 5826 <!-- TYPE --> 5827 <div style="display:inline"> 5828 ( 5829 <span class="optional" style="display: none; ">optional</span> 5830 <span class="enum" style="display: none; ">enumerated</span> 5831 <span id="typeTemplate"> 5832 <span style="display: none; "> 5833 <a> Type</a> 5834 </span> 5835 <span> 5836 <span style="display: none; "> 5837 array of <span><span></span></span> 5838 </span> 5839 <span>integer</span> 5840 <span style="display: none; "></span> 5841 </span> 5842 </span> 5843 ) 5844 </div> 5845 5846 </em> 5847 </dt> 5848 <dd class="todo"> 5849 Undocumented. 5850 </dd> 5851 <dd style="display: none; "> 5852 Description of this parameter from the json schema. 5853 </dd> 5854 <dd style="display: none; "> 5855 This parameter was added in version 5856 <b><span></span></b>. 5857 You must omit this parameter in earlier versions, 5858 and you may omit it in any version. If you require this 5859 parameter, the manifest key 5860 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5861 can ensure that your extension won't be run in an earlier browser version. 5862 </dd> 5863 5864 <!-- OBJECT PROPERTIES --> 5865 <dd style="display: none; "> 5866 <dl> 5867 <div> 5868 <div> 5869 </div> 5870 </div> 5871 </dl> 5872 </dd> 5873 5874 <!-- OBJECT METHODS --> 5875 <dd style="display: none; "> 5876 <div></div> 5877 </dd> 5878 5879 <!-- OBJECT EVENT FIELDS --> 5880 <dd style="display: none; "> 5881 <div></div> 5882 </dd> 5883 5884 <!-- FUNCTION PARAMETERS --> 5885 <dd style="display: none; "> 5886 <div></div> 5887 </dd> 5888 5889 </div> 5890 </div><div> 5891 <div> 5892 <dt> 5893 <var>newPosition</var> 5894 <em> 5895 5896 <!-- TYPE --> 5897 <div style="display:inline"> 5898 ( 5899 <span class="optional" style="display: none; ">optional</span> 5900 <span class="enum" style="display: none; ">enumerated</span> 5901 <span id="typeTemplate"> 5902 <span style="display: none; "> 5903 <a> Type</a> 5904 </span> 5905 <span> 5906 <span style="display: none; "> 5907 array of <span><span></span></span> 5908 </span> 5909 <span>integer</span> 5910 <span style="display: none; "></span> 5911 </span> 5912 </span> 5913 ) 5914 </div> 5915 5916 </em> 5917 </dt> 5918 <dd class="todo"> 5919 Undocumented. 5920 </dd> 5921 <dd style="display: none; "> 5922 Description of this parameter from the json schema. 5923 </dd> 5924 <dd style="display: none; "> 5925 This parameter was added in version 5926 <b><span></span></b>. 5927 You must omit this parameter in earlier versions, 5928 and you may omit it in any version. If you require this 5929 parameter, the manifest key 5930 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 5931 can ensure that your extension won't be run in an earlier browser version. 5932 </dd> 5933 5934 <!-- OBJECT PROPERTIES --> 5935 <dd style="display: none; "> 5936 <dl> 5937 <div> 5938 <div> 5939 </div> 5940 </div> 5941 </dl> 5942 </dd> 5943 5944 <!-- OBJECT METHODS --> 5945 <dd style="display: none; "> 5946 <div></div> 5947 </dd> 5948 5949 <!-- OBJECT EVENT FIELDS --> 5950 <dd style="display: none; "> 5951 <div></div> 5952 </dd> 5953 5954 <!-- FUNCTION PARAMETERS --> 5955 <dd style="display: none; "> 5956 <div></div> 5957 </dd> 5958 5959 </div> 5960 </div> 5961 </dl> 5962 </dd> 5963 5964 <!-- OBJECT METHODS --> 5965 <dd style="display: none; "> 5966 <div></div> 5967 </dd> 5968 5969 <!-- OBJECT EVENT FIELDS --> 5970 <dd style="display: none; "> 5971 <div></div> 5972 </dd> 5973 5974 <!-- FUNCTION PARAMETERS --> 5975 <dd style="display: none; "> 5976 <div></div> 5977 </dd> 5978 5979 </div> 5980 </div> 5981 </dl> 5982 </div> 5983 </div> <!-- /decription --> 5984 5985 </div><div class="apiItem"> 5986 <a name="event-onCreated"></a> 5987 <h4>onCreated</h4> 5988 5989 <div class="summary"> 5990 <!-- Note: intentionally longer 80 columns --> 5991 <span class="subdued">chrome.tabs.</span><span>onCreated</span><span class="subdued">.addListener</span>(function(<span>Tab tab</span>) <span class="subdued">{...}</span>); 5992 </div> 5993 5994 <div class="description"> 5995 <p class="todo" style="display: none; ">Undocumented.</p> 5996 <p>Fires when a tab is created. Note that the tab's URL may not be set at the time this event fires, but you can listen to onUpdated events to be notified when a URL is set.</p> 5997 5998 <!-- PARAMETERS --> 5999 <div> 6000 <h4>Parameters</h4> 6001 <dl> 6002 <div> 6003 <div> 6004 <dt> 6005 <var>tab</var> 6006 <em> 6007 6008 <!-- TYPE --> 6009 <div style="display:inline"> 6010 ( 6011 <span class="optional" style="display: none; ">optional</span> 6012 <span class="enum" style="display: none; ">enumerated</span> 6013 <span id="typeTemplate"> 6014 <span> 6015 <a href="tabs.html#type-Tab">Tab</a> 6016 </span> 6017 <span style="display: none; "> 6018 <span> 6019 array of <span><span></span></span> 6020 </span> 6021 <span>paramType</span> 6022 <span></span> 6023 </span> 6024 </span> 6025 ) 6026 </div> 6027 6028 </em> 6029 </dt> 6030 <dd class="todo" style="display: none; "> 6031 Undocumented. 6032 </dd> 6033 <dd>Details of the tab that was created.</dd> 6034 <dd style="display: none; "> 6035 This parameter was added in version 6036 <b><span></span></b>. 6037 You must omit this parameter in earlier versions, 6038 and you may omit it in any version. If you require this 6039 parameter, the manifest key 6040 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6041 can ensure that your extension won't be run in an earlier browser version. 6042 </dd> 6043 6044 <!-- OBJECT PROPERTIES --> 6045 <dd style="display: none; "> 6046 <dl> 6047 <div> 6048 <div> 6049 </div> 6050 </div> 6051 </dl> 6052 </dd> 6053 6054 <!-- OBJECT METHODS --> 6055 <dd style="display: none; "> 6056 <div></div> 6057 </dd> 6058 6059 <!-- OBJECT EVENT FIELDS --> 6060 <dd style="display: none; "> 6061 <div></div> 6062 </dd> 6063 6064 <!-- FUNCTION PARAMETERS --> 6065 <dd style="display: none; "> 6066 <div></div> 6067 </dd> 6068 6069 </div> 6070 </div> 6071 </dl> 6072 </div> 6073 </div> <!-- /decription --> 6074 6075 </div><div class="apiItem"> 6076 <a name="event-onDetached"></a> 6077 <h4>onDetached</h4> 6078 6079 <div class="summary"> 6080 <!-- Note: intentionally longer 80 columns --> 6081 <span class="subdued">chrome.tabs.</span><span>onDetached</span><span class="subdued">.addListener</span>(function(<span>integer tabId, object detachInfo</span>) <span class="subdued">{...}</span>); 6082 </div> 6083 6084 <div class="description"> 6085 <p class="todo" style="display: none; ">Undocumented.</p> 6086 <p>Fired when a tab is detached from a window, for example because it is being moved between windows.</p> 6087 6088 <!-- PARAMETERS --> 6089 <div> 6090 <h4>Parameters</h4> 6091 <dl> 6092 <div> 6093 <div> 6094 <dt> 6095 <var>tabId</var> 6096 <em> 6097 6098 <!-- TYPE --> 6099 <div style="display:inline"> 6100 ( 6101 <span class="optional" style="display: none; ">optional</span> 6102 <span class="enum" style="display: none; ">enumerated</span> 6103 <span id="typeTemplate"> 6104 <span style="display: none; "> 6105 <a> Type</a> 6106 </span> 6107 <span> 6108 <span style="display: none; "> 6109 array of <span><span></span></span> 6110 </span> 6111 <span>integer</span> 6112 <span style="display: none; "></span> 6113 </span> 6114 </span> 6115 ) 6116 </div> 6117 6118 </em> 6119 </dt> 6120 <dd class="todo"> 6121 Undocumented. 6122 </dd> 6123 <dd style="display: none; "> 6124 Description of this parameter from the json schema. 6125 </dd> 6126 <dd style="display: none; "> 6127 This parameter was added in version 6128 <b><span></span></b>. 6129 You must omit this parameter in earlier versions, 6130 and you may omit it in any version. If you require this 6131 parameter, the manifest key 6132 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6133 can ensure that your extension won't be run in an earlier browser version. 6134 </dd> 6135 6136 <!-- OBJECT PROPERTIES --> 6137 <dd style="display: none; "> 6138 <dl> 6139 <div> 6140 <div> 6141 </div> 6142 </div> 6143 </dl> 6144 </dd> 6145 6146 <!-- OBJECT METHODS --> 6147 <dd style="display: none; "> 6148 <div></div> 6149 </dd> 6150 6151 <!-- OBJECT EVENT FIELDS --> 6152 <dd style="display: none; "> 6153 <div></div> 6154 </dd> 6155 6156 <!-- FUNCTION PARAMETERS --> 6157 <dd style="display: none; "> 6158 <div></div> 6159 </dd> 6160 6161 </div> 6162 </div><div> 6163 <div> 6164 <dt> 6165 <var>detachInfo</var> 6166 <em> 6167 6168 <!-- TYPE --> 6169 <div style="display:inline"> 6170 ( 6171 <span class="optional" style="display: none; ">optional</span> 6172 <span class="enum" style="display: none; ">enumerated</span> 6173 <span id="typeTemplate"> 6174 <span style="display: none; "> 6175 <a> Type</a> 6176 </span> 6177 <span> 6178 <span style="display: none; "> 6179 array of <span><span></span></span> 6180 </span> 6181 <span>object</span> 6182 <span style="display: none; "></span> 6183 </span> 6184 </span> 6185 ) 6186 </div> 6187 6188 </em> 6189 </dt> 6190 <dd class="todo"> 6191 Undocumented. 6192 </dd> 6193 <dd style="display: none; "> 6194 Description of this parameter from the json schema. 6195 </dd> 6196 <dd style="display: none; "> 6197 This parameter was added in version 6198 <b><span></span></b>. 6199 You must omit this parameter in earlier versions, 6200 and you may omit it in any version. If you require this 6201 parameter, the manifest key 6202 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6203 can ensure that your extension won't be run in an earlier browser version. 6204 </dd> 6205 6206 <!-- OBJECT PROPERTIES --> 6207 <dd> 6208 <dl> 6209 <div> 6210 <div> 6211 <dt> 6212 <var>oldWindowId</var> 6213 <em> 6214 6215 <!-- TYPE --> 6216 <div style="display:inline"> 6217 ( 6218 <span class="optional" style="display: none; ">optional</span> 6219 <span class="enum" style="display: none; ">enumerated</span> 6220 <span id="typeTemplate"> 6221 <span style="display: none; "> 6222 <a> Type</a> 6223 </span> 6224 <span> 6225 <span style="display: none; "> 6226 array of <span><span></span></span> 6227 </span> 6228 <span>integer</span> 6229 <span style="display: none; "></span> 6230 </span> 6231 </span> 6232 ) 6233 </div> 6234 6235 </em> 6236 </dt> 6237 <dd class="todo"> 6238 Undocumented. 6239 </dd> 6240 <dd style="display: none; "> 6241 Description of this parameter from the json schema. 6242 </dd> 6243 <dd style="display: none; "> 6244 This parameter was added in version 6245 <b><span></span></b>. 6246 You must omit this parameter in earlier versions, 6247 and you may omit it in any version. If you require this 6248 parameter, the manifest key 6249 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6250 can ensure that your extension won't be run in an earlier browser version. 6251 </dd> 6252 6253 <!-- OBJECT PROPERTIES --> 6254 <dd style="display: none; "> 6255 <dl> 6256 <div> 6257 <div> 6258 </div> 6259 </div> 6260 </dl> 6261 </dd> 6262 6263 <!-- OBJECT METHODS --> 6264 <dd style="display: none; "> 6265 <div></div> 6266 </dd> 6267 6268 <!-- OBJECT EVENT FIELDS --> 6269 <dd style="display: none; "> 6270 <div></div> 6271 </dd> 6272 6273 <!-- FUNCTION PARAMETERS --> 6274 <dd style="display: none; "> 6275 <div></div> 6276 </dd> 6277 6278 </div> 6279 </div><div> 6280 <div> 6281 <dt> 6282 <var>oldPosition</var> 6283 <em> 6284 6285 <!-- TYPE --> 6286 <div style="display:inline"> 6287 ( 6288 <span class="optional" style="display: none; ">optional</span> 6289 <span class="enum" style="display: none; ">enumerated</span> 6290 <span id="typeTemplate"> 6291 <span style="display: none; "> 6292 <a> Type</a> 6293 </span> 6294 <span> 6295 <span style="display: none; "> 6296 array of <span><span></span></span> 6297 </span> 6298 <span>integer</span> 6299 <span style="display: none; "></span> 6300 </span> 6301 </span> 6302 ) 6303 </div> 6304 6305 </em> 6306 </dt> 6307 <dd class="todo"> 6308 Undocumented. 6309 </dd> 6310 <dd style="display: none; "> 6311 Description of this parameter from the json schema. 6312 </dd> 6313 <dd style="display: none; "> 6314 This parameter was added in version 6315 <b><span></span></b>. 6316 You must omit this parameter in earlier versions, 6317 and you may omit it in any version. If you require this 6318 parameter, the manifest key 6319 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6320 can ensure that your extension won't be run in an earlier browser version. 6321 </dd> 6322 6323 <!-- OBJECT PROPERTIES --> 6324 <dd style="display: none; "> 6325 <dl> 6326 <div> 6327 <div> 6328 </div> 6329 </div> 6330 </dl> 6331 </dd> 6332 6333 <!-- OBJECT METHODS --> 6334 <dd style="display: none; "> 6335 <div></div> 6336 </dd> 6337 6338 <!-- OBJECT EVENT FIELDS --> 6339 <dd style="display: none; "> 6340 <div></div> 6341 </dd> 6342 6343 <!-- FUNCTION PARAMETERS --> 6344 <dd style="display: none; "> 6345 <div></div> 6346 </dd> 6347 6348 </div> 6349 </div> 6350 </dl> 6351 </dd> 6352 6353 <!-- OBJECT METHODS --> 6354 <dd style="display: none; "> 6355 <div></div> 6356 </dd> 6357 6358 <!-- OBJECT EVENT FIELDS --> 6359 <dd style="display: none; "> 6360 <div></div> 6361 </dd> 6362 6363 <!-- FUNCTION PARAMETERS --> 6364 <dd style="display: none; "> 6365 <div></div> 6366 </dd> 6367 6368 </div> 6369 </div> 6370 </dl> 6371 </div> 6372 </div> <!-- /decription --> 6373 6374 </div><div class="apiItem"> 6375 <a name="event-onMoved"></a> 6376 <h4>onMoved</h4> 6377 6378 <div class="summary"> 6379 <!-- Note: intentionally longer 80 columns --> 6380 <span class="subdued">chrome.tabs.</span><span>onMoved</span><span class="subdued">.addListener</span>(function(<span>integer tabId, object moveInfo</span>) <span class="subdued">{...}</span>); 6381 </div> 6382 6383 <div class="description"> 6384 <p class="todo" style="display: none; ">Undocumented.</p> 6385 <p>Fires when a tab is moved within a window. Only one move event is fired, representing the tab the user directly moved. Move events are not fired for the other tabs that must move in response. This event is not fired when a tab is moved between windows. For that, see <a href="#event-onDetached">onDetached</a>.</p> 6386 6387 <!-- PARAMETERS --> 6388 <div> 6389 <h4>Parameters</h4> 6390 <dl> 6391 <div> 6392 <div> 6393 <dt> 6394 <var>tabId</var> 6395 <em> 6396 6397 <!-- TYPE --> 6398 <div style="display:inline"> 6399 ( 6400 <span class="optional" style="display: none; ">optional</span> 6401 <span class="enum" style="display: none; ">enumerated</span> 6402 <span id="typeTemplate"> 6403 <span style="display: none; "> 6404 <a> Type</a> 6405 </span> 6406 <span> 6407 <span style="display: none; "> 6408 array of <span><span></span></span> 6409 </span> 6410 <span>integer</span> 6411 <span style="display: none; "></span> 6412 </span> 6413 </span> 6414 ) 6415 </div> 6416 6417 </em> 6418 </dt> 6419 <dd class="todo"> 6420 Undocumented. 6421 </dd> 6422 <dd style="display: none; "> 6423 Description of this parameter from the json schema. 6424 </dd> 6425 <dd style="display: none; "> 6426 This parameter was added in version 6427 <b><span></span></b>. 6428 You must omit this parameter in earlier versions, 6429 and you may omit it in any version. If you require this 6430 parameter, the manifest key 6431 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6432 can ensure that your extension won't be run in an earlier browser version. 6433 </dd> 6434 6435 <!-- OBJECT PROPERTIES --> 6436 <dd style="display: none; "> 6437 <dl> 6438 <div> 6439 <div> 6440 </div> 6441 </div> 6442 </dl> 6443 </dd> 6444 6445 <!-- OBJECT METHODS --> 6446 <dd style="display: none; "> 6447 <div></div> 6448 </dd> 6449 6450 <!-- OBJECT EVENT FIELDS --> 6451 <dd style="display: none; "> 6452 <div></div> 6453 </dd> 6454 6455 <!-- FUNCTION PARAMETERS --> 6456 <dd style="display: none; "> 6457 <div></div> 6458 </dd> 6459 6460 </div> 6461 </div><div> 6462 <div> 6463 <dt> 6464 <var>moveInfo</var> 6465 <em> 6466 6467 <!-- TYPE --> 6468 <div style="display:inline"> 6469 ( 6470 <span class="optional" style="display: none; ">optional</span> 6471 <span class="enum" style="display: none; ">enumerated</span> 6472 <span id="typeTemplate"> 6473 <span style="display: none; "> 6474 <a> Type</a> 6475 </span> 6476 <span> 6477 <span style="display: none; "> 6478 array of <span><span></span></span> 6479 </span> 6480 <span>object</span> 6481 <span style="display: none; "></span> 6482 </span> 6483 </span> 6484 ) 6485 </div> 6486 6487 </em> 6488 </dt> 6489 <dd class="todo"> 6490 Undocumented. 6491 </dd> 6492 <dd style="display: none; "> 6493 Description of this parameter from the json schema. 6494 </dd> 6495 <dd style="display: none; "> 6496 This parameter was added in version 6497 <b><span></span></b>. 6498 You must omit this parameter in earlier versions, 6499 and you may omit it in any version. If you require this 6500 parameter, the manifest key 6501 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6502 can ensure that your extension won't be run in an earlier browser version. 6503 </dd> 6504 6505 <!-- OBJECT PROPERTIES --> 6506 <dd> 6507 <dl> 6508 <div> 6509 <div> 6510 <dt> 6511 <var>windowId</var> 6512 <em> 6513 6514 <!-- TYPE --> 6515 <div style="display:inline"> 6516 ( 6517 <span class="optional" style="display: none; ">optional</span> 6518 <span class="enum" style="display: none; ">enumerated</span> 6519 <span id="typeTemplate"> 6520 <span style="display: none; "> 6521 <a> Type</a> 6522 </span> 6523 <span> 6524 <span style="display: none; "> 6525 array of <span><span></span></span> 6526 </span> 6527 <span>integer</span> 6528 <span style="display: none; "></span> 6529 </span> 6530 </span> 6531 ) 6532 </div> 6533 6534 </em> 6535 </dt> 6536 <dd class="todo"> 6537 Undocumented. 6538 </dd> 6539 <dd style="display: none; "> 6540 Description of this parameter from the json schema. 6541 </dd> 6542 <dd style="display: none; "> 6543 This parameter was added in version 6544 <b><span></span></b>. 6545 You must omit this parameter in earlier versions, 6546 and you may omit it in any version. If you require this 6547 parameter, the manifest key 6548 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6549 can ensure that your extension won't be run in an earlier browser version. 6550 </dd> 6551 6552 <!-- OBJECT PROPERTIES --> 6553 <dd style="display: none; "> 6554 <dl> 6555 <div> 6556 <div> 6557 </div> 6558 </div> 6559 </dl> 6560 </dd> 6561 6562 <!-- OBJECT METHODS --> 6563 <dd style="display: none; "> 6564 <div></div> 6565 </dd> 6566 6567 <!-- OBJECT EVENT FIELDS --> 6568 <dd style="display: none; "> 6569 <div></div> 6570 </dd> 6571 6572 <!-- FUNCTION PARAMETERS --> 6573 <dd style="display: none; "> 6574 <div></div> 6575 </dd> 6576 6577 </div> 6578 </div><div> 6579 <div> 6580 <dt> 6581 <var>fromIndex</var> 6582 <em> 6583 6584 <!-- TYPE --> 6585 <div style="display:inline"> 6586 ( 6587 <span class="optional" style="display: none; ">optional</span> 6588 <span class="enum" style="display: none; ">enumerated</span> 6589 <span id="typeTemplate"> 6590 <span style="display: none; "> 6591 <a> Type</a> 6592 </span> 6593 <span> 6594 <span style="display: none; "> 6595 array of <span><span></span></span> 6596 </span> 6597 <span>integer</span> 6598 <span style="display: none; "></span> 6599 </span> 6600 </span> 6601 ) 6602 </div> 6603 6604 </em> 6605 </dt> 6606 <dd class="todo"> 6607 Undocumented. 6608 </dd> 6609 <dd style="display: none; "> 6610 Description of this parameter from the json schema. 6611 </dd> 6612 <dd style="display: none; "> 6613 This parameter was added in version 6614 <b><span></span></b>. 6615 You must omit this parameter in earlier versions, 6616 and you may omit it in any version. If you require this 6617 parameter, the manifest key 6618 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6619 can ensure that your extension won't be run in an earlier browser version. 6620 </dd> 6621 6622 <!-- OBJECT PROPERTIES --> 6623 <dd style="display: none; "> 6624 <dl> 6625 <div> 6626 <div> 6627 </div> 6628 </div> 6629 </dl> 6630 </dd> 6631 6632 <!-- OBJECT METHODS --> 6633 <dd style="display: none; "> 6634 <div></div> 6635 </dd> 6636 6637 <!-- OBJECT EVENT FIELDS --> 6638 <dd style="display: none; "> 6639 <div></div> 6640 </dd> 6641 6642 <!-- FUNCTION PARAMETERS --> 6643 <dd style="display: none; "> 6644 <div></div> 6645 </dd> 6646 6647 </div> 6648 </div><div> 6649 <div> 6650 <dt> 6651 <var>toIndex</var> 6652 <em> 6653 6654 <!-- TYPE --> 6655 <div style="display:inline"> 6656 ( 6657 <span class="optional" style="display: none; ">optional</span> 6658 <span class="enum" style="display: none; ">enumerated</span> 6659 <span id="typeTemplate"> 6660 <span style="display: none; "> 6661 <a> Type</a> 6662 </span> 6663 <span> 6664 <span style="display: none; "> 6665 array of <span><span></span></span> 6666 </span> 6667 <span>integer</span> 6668 <span style="display: none; "></span> 6669 </span> 6670 </span> 6671 ) 6672 </div> 6673 6674 </em> 6675 </dt> 6676 <dd class="todo"> 6677 Undocumented. 6678 </dd> 6679 <dd style="display: none; "> 6680 Description of this parameter from the json schema. 6681 </dd> 6682 <dd style="display: none; "> 6683 This parameter was added in version 6684 <b><span></span></b>. 6685 You must omit this parameter in earlier versions, 6686 and you may omit it in any version. If you require this 6687 parameter, the manifest key 6688 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6689 can ensure that your extension won't be run in an earlier browser version. 6690 </dd> 6691 6692 <!-- OBJECT PROPERTIES --> 6693 <dd style="display: none; "> 6694 <dl> 6695 <div> 6696 <div> 6697 </div> 6698 </div> 6699 </dl> 6700 </dd> 6701 6702 <!-- OBJECT METHODS --> 6703 <dd style="display: none; "> 6704 <div></div> 6705 </dd> 6706 6707 <!-- OBJECT EVENT FIELDS --> 6708 <dd style="display: none; "> 6709 <div></div> 6710 </dd> 6711 6712 <!-- FUNCTION PARAMETERS --> 6713 <dd style="display: none; "> 6714 <div></div> 6715 </dd> 6716 6717 </div> 6718 </div> 6719 </dl> 6720 </dd> 6721 6722 <!-- OBJECT METHODS --> 6723 <dd style="display: none; "> 6724 <div></div> 6725 </dd> 6726 6727 <!-- OBJECT EVENT FIELDS --> 6728 <dd style="display: none; "> 6729 <div></div> 6730 </dd> 6731 6732 <!-- FUNCTION PARAMETERS --> 6733 <dd style="display: none; "> 6734 <div></div> 6735 </dd> 6736 6737 </div> 6738 </div> 6739 </dl> 6740 </div> 6741 </div> <!-- /decription --> 6742 6743 </div><div class="apiItem"> 6744 <a name="event-onRemoved"></a> 6745 <h4>onRemoved</h4> 6746 6747 <div class="summary"> 6748 <!-- Note: intentionally longer 80 columns --> 6749 <span class="subdued">chrome.tabs.</span><span>onRemoved</span><span class="subdued">.addListener</span>(function(<span>integer tabId, object removeInfo</span>) <span class="subdued">{...}</span>); 6750 </div> 6751 6752 <div class="description"> 6753 <p class="todo" style="display: none; ">Undocumented.</p> 6754 <p>Fires when a tab is closed.</p> 6755 6756 <!-- PARAMETERS --> 6757 <div> 6758 <h4>Parameters</h4> 6759 <dl> 6760 <div> 6761 <div> 6762 <dt> 6763 <var>tabId</var> 6764 <em> 6765 6766 <!-- TYPE --> 6767 <div style="display:inline"> 6768 ( 6769 <span class="optional" style="display: none; ">optional</span> 6770 <span class="enum" style="display: none; ">enumerated</span> 6771 <span id="typeTemplate"> 6772 <span style="display: none; "> 6773 <a> Type</a> 6774 </span> 6775 <span> 6776 <span style="display: none; "> 6777 array of <span><span></span></span> 6778 </span> 6779 <span>integer</span> 6780 <span style="display: none; "></span> 6781 </span> 6782 </span> 6783 ) 6784 </div> 6785 6786 </em> 6787 </dt> 6788 <dd class="todo"> 6789 Undocumented. 6790 </dd> 6791 <dd style="display: none; "> 6792 Description of this parameter from the json schema. 6793 </dd> 6794 <dd style="display: none; "> 6795 This parameter was added in version 6796 <b><span></span></b>. 6797 You must omit this parameter in earlier versions, 6798 and you may omit it in any version. If you require this 6799 parameter, the manifest key 6800 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6801 can ensure that your extension won't be run in an earlier browser version. 6802 </dd> 6803 6804 <!-- OBJECT PROPERTIES --> 6805 <dd style="display: none; "> 6806 <dl> 6807 <div> 6808 <div> 6809 </div> 6810 </div> 6811 </dl> 6812 </dd> 6813 6814 <!-- OBJECT METHODS --> 6815 <dd style="display: none; "> 6816 <div></div> 6817 </dd> 6818 6819 <!-- OBJECT EVENT FIELDS --> 6820 <dd style="display: none; "> 6821 <div></div> 6822 </dd> 6823 6824 <!-- FUNCTION PARAMETERS --> 6825 <dd style="display: none; "> 6826 <div></div> 6827 </dd> 6828 6829 </div> 6830 </div><div> 6831 <div> 6832 <dt> 6833 <var>removeInfo</var> 6834 <em> 6835 6836 <!-- TYPE --> 6837 <div style="display:inline"> 6838 ( 6839 <span class="optional" style="display: none; ">optional</span> 6840 <span class="enum" style="display: none; ">enumerated</span> 6841 <span id="typeTemplate"> 6842 <span style="display: none; "> 6843 <a> Type</a> 6844 </span> 6845 <span> 6846 <span style="display: none; "> 6847 array of <span><span></span></span> 6848 </span> 6849 <span>object</span> 6850 <span style="display: none; "></span> 6851 </span> 6852 </span> 6853 ) 6854 </div> 6855 6856 </em> 6857 </dt> 6858 <dd class="todo"> 6859 Undocumented. 6860 </dd> 6861 <dd style="display: none; "> 6862 Description of this parameter from the json schema. 6863 </dd> 6864 <dd style="display: none; "> 6865 This parameter was added in version 6866 <b><span></span></b>. 6867 You must omit this parameter in earlier versions, 6868 and you may omit it in any version. If you require this 6869 parameter, the manifest key 6870 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6871 can ensure that your extension won't be run in an earlier browser version. 6872 </dd> 6873 6874 <!-- OBJECT PROPERTIES --> 6875 <dd> 6876 <dl> 6877 <div> 6878 <div> 6879 <dt> 6880 <var>isWindowClosing</var> 6881 <em> 6882 6883 <!-- TYPE --> 6884 <div style="display:inline"> 6885 ( 6886 <span class="optional" style="display: none; ">optional</span> 6887 <span class="enum" style="display: none; ">enumerated</span> 6888 <span id="typeTemplate"> 6889 <span style="display: none; "> 6890 <a> Type</a> 6891 </span> 6892 <span> 6893 <span style="display: none; "> 6894 array of <span><span></span></span> 6895 </span> 6896 <span>boolean</span> 6897 <span style="display: none; "></span> 6898 </span> 6899 </span> 6900 ) 6901 </div> 6902 6903 </em> 6904 </dt> 6905 <dd class="todo" style="display: none; "> 6906 Undocumented. 6907 </dd> 6908 <dd>True when the tab is being closed because its window is being closed.</dd> 6909 <dd style="display: none; "> 6910 This parameter was added in version 6911 <b><span></span></b>. 6912 You must omit this parameter in earlier versions, 6913 and you may omit it in any version. If you require this 6914 parameter, the manifest key 6915 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 6916 can ensure that your extension won't be run in an earlier browser version. 6917 </dd> 6918 6919 <!-- OBJECT PROPERTIES --> 6920 <dd style="display: none; "> 6921 <dl> 6922 <div> 6923 <div> 6924 </div> 6925 </div> 6926 </dl> 6927 </dd> 6928 6929 <!-- OBJECT METHODS --> 6930 <dd style="display: none; "> 6931 <div></div> 6932 </dd> 6933 6934 <!-- OBJECT EVENT FIELDS --> 6935 <dd style="display: none; "> 6936 <div></div> 6937 </dd> 6938 6939 <!-- FUNCTION PARAMETERS --> 6940 <dd style="display: none; "> 6941 <div></div> 6942 </dd> 6943 6944 </div> 6945 </div> 6946 </dl> 6947 </dd> 6948 6949 <!-- OBJECT METHODS --> 6950 <dd style="display: none; "> 6951 <div></div> 6952 </dd> 6953 6954 <!-- OBJECT EVENT FIELDS --> 6955 <dd style="display: none; "> 6956 <div></div> 6957 </dd> 6958 6959 <!-- FUNCTION PARAMETERS --> 6960 <dd style="display: none; "> 6961 <div></div> 6962 </dd> 6963 6964 </div> 6965 </div> 6966 </dl> 6967 </div> 6968 </div> <!-- /decription --> 6969 6970 </div><div class="apiItem"> 6971 <a name="event-onSelectionChanged"></a> 6972 <h4>onSelectionChanged</h4> 6973 6974 <div class="summary"> 6975 <!-- Note: intentionally longer 80 columns --> 6976 <span class="subdued">chrome.tabs.</span><span>onSelectionChanged</span><span class="subdued">.addListener</span>(function(<span>integer tabId, object selectInfo</span>) <span class="subdued">{...}</span>); 6977 </div> 6978 6979 <div class="description"> 6980 <p class="todo" style="display: none; ">Undocumented.</p> 6981 <p>Fires when the selected tab in a window changes.</p> 6982 6983 <!-- PARAMETERS --> 6984 <div> 6985 <h4>Parameters</h4> 6986 <dl> 6987 <div> 6988 <div> 6989 <dt> 6990 <var>tabId</var> 6991 <em> 6992 6993 <!-- TYPE --> 6994 <div style="display:inline"> 6995 ( 6996 <span class="optional" style="display: none; ">optional</span> 6997 <span class="enum" style="display: none; ">enumerated</span> 6998 <span id="typeTemplate"> 6999 <span style="display: none; "> 7000 <a> Type</a> 7001 </span> 7002 <span> 7003 <span style="display: none; "> 7004 array of <span><span></span></span> 7005 </span> 7006 <span>integer</span> 7007 <span style="display: none; "></span> 7008 </span> 7009 </span> 7010 ) 7011 </div> 7012 7013 </em> 7014 </dt> 7015 <dd class="todo" style="display: none; "> 7016 Undocumented. 7017 </dd> 7018 <dd>The ID of the tab that has become selected.</dd> 7019 <dd style="display: none; "> 7020 This parameter was added in version 7021 <b><span></span></b>. 7022 You must omit this parameter in earlier versions, 7023 and you may omit it in any version. If you require this 7024 parameter, the manifest key 7025 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7026 can ensure that your extension won't be run in an earlier browser version. 7027 </dd> 7028 7029 <!-- OBJECT PROPERTIES --> 7030 <dd style="display: none; "> 7031 <dl> 7032 <div> 7033 <div> 7034 </div> 7035 </div> 7036 </dl> 7037 </dd> 7038 7039 <!-- OBJECT METHODS --> 7040 <dd style="display: none; "> 7041 <div></div> 7042 </dd> 7043 7044 <!-- OBJECT EVENT FIELDS --> 7045 <dd style="display: none; "> 7046 <div></div> 7047 </dd> 7048 7049 <!-- FUNCTION PARAMETERS --> 7050 <dd style="display: none; "> 7051 <div></div> 7052 </dd> 7053 7054 </div> 7055 </div><div> 7056 <div> 7057 <dt> 7058 <var>selectInfo</var> 7059 <em> 7060 7061 <!-- TYPE --> 7062 <div style="display:inline"> 7063 ( 7064 <span class="optional" style="display: none; ">optional</span> 7065 <span class="enum" style="display: none; ">enumerated</span> 7066 <span id="typeTemplate"> 7067 <span style="display: none; "> 7068 <a> Type</a> 7069 </span> 7070 <span> 7071 <span style="display: none; "> 7072 array of <span><span></span></span> 7073 </span> 7074 <span>object</span> 7075 <span style="display: none; "></span> 7076 </span> 7077 </span> 7078 ) 7079 </div> 7080 7081 </em> 7082 </dt> 7083 <dd class="todo"> 7084 Undocumented. 7085 </dd> 7086 <dd style="display: none; "> 7087 Description of this parameter from the json schema. 7088 </dd> 7089 <dd style="display: none; "> 7090 This parameter was added in version 7091 <b><span></span></b>. 7092 You must omit this parameter in earlier versions, 7093 and you may omit it in any version. If you require this 7094 parameter, the manifest key 7095 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7096 can ensure that your extension won't be run in an earlier browser version. 7097 </dd> 7098 7099 <!-- OBJECT PROPERTIES --> 7100 <dd> 7101 <dl> 7102 <div> 7103 <div> 7104 <dt> 7105 <var>windowId</var> 7106 <em> 7107 7108 <!-- TYPE --> 7109 <div style="display:inline"> 7110 ( 7111 <span class="optional" style="display: none; ">optional</span> 7112 <span class="enum" style="display: none; ">enumerated</span> 7113 <span id="typeTemplate"> 7114 <span style="display: none; "> 7115 <a> Type</a> 7116 </span> 7117 <span> 7118 <span style="display: none; "> 7119 array of <span><span></span></span> 7120 </span> 7121 <span>integer</span> 7122 <span style="display: none; "></span> 7123 </span> 7124 </span> 7125 ) 7126 </div> 7127 7128 </em> 7129 </dt> 7130 <dd class="todo" style="display: none; "> 7131 Undocumented. 7132 </dd> 7133 <dd>The ID of the window the selected tab changed inside of.</dd> 7134 <dd style="display: none; "> 7135 This parameter was added in version 7136 <b><span></span></b>. 7137 You must omit this parameter in earlier versions, 7138 and you may omit it in any version. If you require this 7139 parameter, the manifest key 7140 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7141 can ensure that your extension won't be run in an earlier browser version. 7142 </dd> 7143 7144 <!-- OBJECT PROPERTIES --> 7145 <dd style="display: none; "> 7146 <dl> 7147 <div> 7148 <div> 7149 </div> 7150 </div> 7151 </dl> 7152 </dd> 7153 7154 <!-- OBJECT METHODS --> 7155 <dd style="display: none; "> 7156 <div></div> 7157 </dd> 7158 7159 <!-- OBJECT EVENT FIELDS --> 7160 <dd style="display: none; "> 7161 <div></div> 7162 </dd> 7163 7164 <!-- FUNCTION PARAMETERS --> 7165 <dd style="display: none; "> 7166 <div></div> 7167 </dd> 7168 7169 </div> 7170 </div> 7171 </dl> 7172 </dd> 7173 7174 <!-- OBJECT METHODS --> 7175 <dd style="display: none; "> 7176 <div></div> 7177 </dd> 7178 7179 <!-- OBJECT EVENT FIELDS --> 7180 <dd style="display: none; "> 7181 <div></div> 7182 </dd> 7183 7184 <!-- FUNCTION PARAMETERS --> 7185 <dd style="display: none; "> 7186 <div></div> 7187 </dd> 7188 7189 </div> 7190 </div> 7191 </dl> 7192 </div> 7193 </div> <!-- /decription --> 7194 7195 </div><div class="apiItem"> 7196 <a name="event-onUpdated"></a> 7197 <h4>onUpdated</h4> 7198 7199 <div class="summary"> 7200 <!-- Note: intentionally longer 80 columns --> 7201 <span class="subdued">chrome.tabs.</span><span>onUpdated</span><span class="subdued">.addListener</span>(function(<span>integer tabId, object changeInfo, Tab tab</span>) <span class="subdued">{...}</span>); 7202 </div> 7203 7204 <div class="description"> 7205 <p class="todo" style="display: none; ">Undocumented.</p> 7206 <p>Fires when a tab is updated.</p> 7207 7208 <!-- PARAMETERS --> 7209 <div> 7210 <h4>Parameters</h4> 7211 <dl> 7212 <div> 7213 <div> 7214 <dt> 7215 <var>tabId</var> 7216 <em> 7217 7218 <!-- TYPE --> 7219 <div style="display:inline"> 7220 ( 7221 <span class="optional" style="display: none; ">optional</span> 7222 <span class="enum" style="display: none; ">enumerated</span> 7223 <span id="typeTemplate"> 7224 <span style="display: none; "> 7225 <a> Type</a> 7226 </span> 7227 <span> 7228 <span style="display: none; "> 7229 array of <span><span></span></span> 7230 </span> 7231 <span>integer</span> 7232 <span style="display: none; "></span> 7233 </span> 7234 </span> 7235 ) 7236 </div> 7237 7238 </em> 7239 </dt> 7240 <dd class="todo"> 7241 Undocumented. 7242 </dd> 7243 <dd style="display: none; "> 7244 Description of this parameter from the json schema. 7245 </dd> 7246 <dd style="display: none; "> 7247 This parameter was added in version 7248 <b><span></span></b>. 7249 You must omit this parameter in earlier versions, 7250 and you may omit it in any version. If you require this 7251 parameter, the manifest key 7252 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7253 can ensure that your extension won't be run in an earlier browser version. 7254 </dd> 7255 7256 <!-- OBJECT PROPERTIES --> 7257 <dd style="display: none; "> 7258 <dl> 7259 <div> 7260 <div> 7261 </div> 7262 </div> 7263 </dl> 7264 </dd> 7265 7266 <!-- OBJECT METHODS --> 7267 <dd style="display: none; "> 7268 <div></div> 7269 </dd> 7270 7271 <!-- OBJECT EVENT FIELDS --> 7272 <dd style="display: none; "> 7273 <div></div> 7274 </dd> 7275 7276 <!-- FUNCTION PARAMETERS --> 7277 <dd style="display: none; "> 7278 <div></div> 7279 </dd> 7280 7281 </div> 7282 </div><div> 7283 <div> 7284 <dt> 7285 <var>changeInfo</var> 7286 <em> 7287 7288 <!-- TYPE --> 7289 <div style="display:inline"> 7290 ( 7291 <span class="optional" style="display: none; ">optional</span> 7292 <span class="enum" style="display: none; ">enumerated</span> 7293 <span id="typeTemplate"> 7294 <span style="display: none; "> 7295 <a> Type</a> 7296 </span> 7297 <span> 7298 <span style="display: none; "> 7299 array of <span><span></span></span> 7300 </span> 7301 <span>object</span> 7302 <span style="display: none; "></span> 7303 </span> 7304 </span> 7305 ) 7306 </div> 7307 7308 </em> 7309 </dt> 7310 <dd class="todo" style="display: none; "> 7311 Undocumented. 7312 </dd> 7313 <dd>Lists the changes to the state of the tab that was updated.</dd> 7314 <dd style="display: none; "> 7315 This parameter was added in version 7316 <b><span></span></b>. 7317 You must omit this parameter in earlier versions, 7318 and you may omit it in any version. If you require this 7319 parameter, the manifest key 7320 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7321 can ensure that your extension won't be run in an earlier browser version. 7322 </dd> 7323 7324 <!-- OBJECT PROPERTIES --> 7325 <dd> 7326 <dl> 7327 <div> 7328 <div> 7329 <dt> 7330 <var>status</var> 7331 <em> 7332 7333 <!-- TYPE --> 7334 <div style="display:inline"> 7335 ( 7336 <span class="optional">optional</span> 7337 <span class="enum" style="display: none; ">enumerated</span> 7338 <span id="typeTemplate"> 7339 <span style="display: none; "> 7340 <a> Type</a> 7341 </span> 7342 <span> 7343 <span style="display: none; "> 7344 array of <span><span></span></span> 7345 </span> 7346 <span>string</span> 7347 <span style="display: none; "></span> 7348 </span> 7349 </span> 7350 ) 7351 </div> 7352 7353 </em> 7354 </dt> 7355 <dd class="todo" style="display: none; "> 7356 Undocumented. 7357 </dd> 7358 <dd>The status of the tab. Can be either <em>loading</em> or <em>complete</em>.</dd> 7359 <dd style="display: none; "> 7360 This parameter was added in version 7361 <b><span></span></b>. 7362 You must omit this parameter in earlier versions, 7363 and you may omit it in any version. If you require this 7364 parameter, the manifest key 7365 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7366 can ensure that your extension won't be run in an earlier browser version. 7367 </dd> 7368 7369 <!-- OBJECT PROPERTIES --> 7370 <dd style="display: none; "> 7371 <dl> 7372 <div> 7373 <div> 7374 </div> 7375 </div> 7376 </dl> 7377 </dd> 7378 7379 <!-- OBJECT METHODS --> 7380 <dd style="display: none; "> 7381 <div></div> 7382 </dd> 7383 7384 <!-- OBJECT EVENT FIELDS --> 7385 <dd style="display: none; "> 7386 <div></div> 7387 </dd> 7388 7389 <!-- FUNCTION PARAMETERS --> 7390 <dd style="display: none; "> 7391 <div></div> 7392 </dd> 7393 7394 </div> 7395 </div><div> 7396 <div> 7397 <dt> 7398 <var>url</var> 7399 <em> 7400 7401 <!-- TYPE --> 7402 <div style="display:inline"> 7403 ( 7404 <span class="optional">optional</span> 7405 <span class="enum" style="display: none; ">enumerated</span> 7406 <span id="typeTemplate"> 7407 <span style="display: none; "> 7408 <a> Type</a> 7409 </span> 7410 <span> 7411 <span style="display: none; "> 7412 array of <span><span></span></span> 7413 </span> 7414 <span>string</span> 7415 <span style="display: none; "></span> 7416 </span> 7417 </span> 7418 ) 7419 </div> 7420 7421 </em> 7422 </dt> 7423 <dd class="todo" style="display: none; "> 7424 Undocumented. 7425 </dd> 7426 <dd>The tab's URL if it has changed.</dd> 7427 <dd style="display: none; "> 7428 This parameter was added in version 7429 <b><span></span></b>. 7430 You must omit this parameter in earlier versions, 7431 and you may omit it in any version. If you require this 7432 parameter, the manifest key 7433 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7434 can ensure that your extension won't be run in an earlier browser version. 7435 </dd> 7436 7437 <!-- OBJECT PROPERTIES --> 7438 <dd style="display: none; "> 7439 <dl> 7440 <div> 7441 <div> 7442 </div> 7443 </div> 7444 </dl> 7445 </dd> 7446 7447 <!-- OBJECT METHODS --> 7448 <dd style="display: none; "> 7449 <div></div> 7450 </dd> 7451 7452 <!-- OBJECT EVENT FIELDS --> 7453 <dd style="display: none; "> 7454 <div></div> 7455 </dd> 7456 7457 <!-- FUNCTION PARAMETERS --> 7458 <dd style="display: none; "> 7459 <div></div> 7460 </dd> 7461 7462 </div> 7463 </div><div> 7464 <div> 7465 <dt> 7466 <var>pinned</var> 7467 <em> 7468 7469 <!-- TYPE --> 7470 <div style="display:inline"> 7471 ( 7472 <span class="optional">optional</span> 7473 <span class="enum" style="display: none; ">enumerated</span> 7474 <span id="typeTemplate"> 7475 <span style="display: none; "> 7476 <a> Type</a> 7477 </span> 7478 <span> 7479 <span style="display: none; "> 7480 array of <span><span></span></span> 7481 </span> 7482 <span>boolean</span> 7483 <span style="display: none; "></span> 7484 </span> 7485 </span> 7486 ) 7487 </div> 7488 7489 </em> 7490 </dt> 7491 <dd class="todo" style="display: none; "> 7492 Undocumented. 7493 </dd> 7494 <dd>The tab's new pinned state.</dd> 7495 <dd style="display: none; "> 7496 This parameter was added in version 7497 <b><span></span></b>. 7498 You must omit this parameter in earlier versions, 7499 and you may omit it in any version. If you require this 7500 parameter, the manifest key 7501 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7502 can ensure that your extension won't be run in an earlier browser version. 7503 </dd> 7504 7505 <!-- OBJECT PROPERTIES --> 7506 <dd style="display: none; "> 7507 <dl> 7508 <div> 7509 <div> 7510 </div> 7511 </div> 7512 </dl> 7513 </dd> 7514 7515 <!-- OBJECT METHODS --> 7516 <dd style="display: none; "> 7517 <div></div> 7518 </dd> 7519 7520 <!-- OBJECT EVENT FIELDS --> 7521 <dd style="display: none; "> 7522 <div></div> 7523 </dd> 7524 7525 <!-- FUNCTION PARAMETERS --> 7526 <dd style="display: none; "> 7527 <div></div> 7528 </dd> 7529 7530 </div> 7531 </div> 7532 </dl> 7533 </dd> 7534 7535 <!-- OBJECT METHODS --> 7536 <dd style="display: none; "> 7537 <div></div> 7538 </dd> 7539 7540 <!-- OBJECT EVENT FIELDS --> 7541 <dd style="display: none; "> 7542 <div></div> 7543 </dd> 7544 7545 <!-- FUNCTION PARAMETERS --> 7546 <dd style="display: none; "> 7547 <div></div> 7548 </dd> 7549 7550 </div> 7551 </div><div> 7552 <div> 7553 <dt> 7554 <var>tab</var> 7555 <em> 7556 7557 <!-- TYPE --> 7558 <div style="display:inline"> 7559 ( 7560 <span class="optional" style="display: none; ">optional</span> 7561 <span class="enum" style="display: none; ">enumerated</span> 7562 <span id="typeTemplate"> 7563 <span> 7564 <a href="tabs.html#type-Tab">Tab</a> 7565 </span> 7566 <span style="display: none; "> 7567 <span> 7568 array of <span><span></span></span> 7569 </span> 7570 <span>paramType</span> 7571 <span></span> 7572 </span> 7573 </span> 7574 ) 7575 </div> 7576 7577 </em> 7578 </dt> 7579 <dd class="todo" style="display: none; "> 7580 Undocumented. 7581 </dd> 7582 <dd>Gives the state of the tab that was updated.</dd> 7583 <dd style="display: none; "> 7584 This parameter was added in version 7585 <b><span></span></b>. 7586 You must omit this parameter in earlier versions, 7587 and you may omit it in any version. If you require this 7588 parameter, the manifest key 7589 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7590 can ensure that your extension won't be run in an earlier browser version. 7591 </dd> 7592 7593 <!-- OBJECT PROPERTIES --> 7594 <dd style="display: none; "> 7595 <dl> 7596 <div> 7597 <div> 7598 </div> 7599 </div> 7600 </dl> 7601 </dd> 7602 7603 <!-- OBJECT METHODS --> 7604 <dd style="display: none; "> 7605 <div></div> 7606 </dd> 7607 7608 <!-- OBJECT EVENT FIELDS --> 7609 <dd style="display: none; "> 7610 <div></div> 7611 </dd> 7612 7613 <!-- FUNCTION PARAMETERS --> 7614 <dd style="display: none; "> 7615 <div></div> 7616 </dd> 7617 7618 </div> 7619 </div> 7620 </dl> 7621 </div> 7622 </div> <!-- /decription --> 7623 7624 </div> <!-- /apiItem --> 7625 7626 </div> <!-- /apiGroup --> 7627 7628 <!-- TYPES --> 7629 <div class="apiGroup"> 7630 <a name="types"></a> 7631 <h3 id="types">Types</h3> 7632 7633 <!-- iterates over all types --> 7634 <div class="apiItem"> 7635 <a name="type-Tab"></a> 7636 <h4>Tab</h4> 7637 7638 <div> 7639 <dt> 7640 <var style="display: none; ">paramName</var> 7641 <em> 7642 7643 <!-- TYPE --> 7644 <div style="display:inline"> 7645 ( 7646 <span class="optional" style="display: none; ">optional</span> 7647 <span class="enum" style="display: none; ">enumerated</span> 7648 <span id="typeTemplate"> 7649 <span style="display: none; "> 7650 <a> Type</a> 7651 </span> 7652 <span> 7653 <span style="display: none; "> 7654 array of <span><span></span></span> 7655 </span> 7656 <span>object</span> 7657 <span style="display: none; "></span> 7658 </span> 7659 </span> 7660 ) 7661 </div> 7662 7663 </em> 7664 </dt> 7665 <dd class="todo"> 7666 Undocumented. 7667 </dd> 7668 <dd style="display: none; "> 7669 Description of this parameter from the json schema. 7670 </dd> 7671 <dd style="display: none; "> 7672 This parameter was added in version 7673 <b><span></span></b>. 7674 You must omit this parameter in earlier versions, 7675 and you may omit it in any version. If you require this 7676 parameter, the manifest key 7677 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7678 can ensure that your extension won't be run in an earlier browser version. 7679 </dd> 7680 7681 <!-- OBJECT PROPERTIES --> 7682 <dd> 7683 <dl> 7684 <div> 7685 <div> 7686 <dt> 7687 <var>id</var> 7688 <em> 7689 7690 <!-- TYPE --> 7691 <div style="display:inline"> 7692 ( 7693 <span class="optional" style="display: none; ">optional</span> 7694 <span class="enum" style="display: none; ">enumerated</span> 7695 <span id="typeTemplate"> 7696 <span style="display: none; "> 7697 <a> Type</a> 7698 </span> 7699 <span> 7700 <span style="display: none; "> 7701 array of <span><span></span></span> 7702 </span> 7703 <span>integer</span> 7704 <span style="display: none; "></span> 7705 </span> 7706 </span> 7707 ) 7708 </div> 7709 7710 </em> 7711 </dt> 7712 <dd class="todo" style="display: none; "> 7713 Undocumented. 7714 </dd> 7715 <dd>The ID of the tab. Tab IDs are unique within a browser session.</dd> 7716 <dd style="display: none; "> 7717 This parameter was added in version 7718 <b><span></span></b>. 7719 You must omit this parameter in earlier versions, 7720 and you may omit it in any version. If you require this 7721 parameter, the manifest key 7722 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7723 can ensure that your extension won't be run in an earlier browser version. 7724 </dd> 7725 7726 <!-- OBJECT PROPERTIES --> 7727 <dd style="display: none; "> 7728 <dl> 7729 <div> 7730 <div> 7731 </div> 7732 </div> 7733 </dl> 7734 </dd> 7735 7736 <!-- OBJECT METHODS --> 7737 <dd style="display: none; "> 7738 <div></div> 7739 </dd> 7740 7741 <!-- OBJECT EVENT FIELDS --> 7742 <dd style="display: none; "> 7743 <div></div> 7744 </dd> 7745 7746 <!-- FUNCTION PARAMETERS --> 7747 <dd style="display: none; "> 7748 <div></div> 7749 </dd> 7750 7751 </div> 7752 </div><div> 7753 <div> 7754 <dt> 7755 <var>index</var> 7756 <em> 7757 7758 <!-- TYPE --> 7759 <div style="display:inline"> 7760 ( 7761 <span class="optional" style="display: none; ">optional</span> 7762 <span class="enum" style="display: none; ">enumerated</span> 7763 <span id="typeTemplate"> 7764 <span style="display: none; "> 7765 <a> Type</a> 7766 </span> 7767 <span> 7768 <span style="display: none; "> 7769 array of <span><span></span></span> 7770 </span> 7771 <span>integer</span> 7772 <span style="display: none; "></span> 7773 </span> 7774 </span> 7775 ) 7776 </div> 7777 7778 </em> 7779 </dt> 7780 <dd class="todo" style="display: none; "> 7781 Undocumented. 7782 </dd> 7783 <dd>The zero-based index of the tab within its window.</dd> 7784 <dd style="display: none; "> 7785 This parameter was added in version 7786 <b><span></span></b>. 7787 You must omit this parameter in earlier versions, 7788 and you may omit it in any version. If you require this 7789 parameter, the manifest key 7790 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7791 can ensure that your extension won't be run in an earlier browser version. 7792 </dd> 7793 7794 <!-- OBJECT PROPERTIES --> 7795 <dd style="display: none; "> 7796 <dl> 7797 <div> 7798 <div> 7799 </div> 7800 </div> 7801 </dl> 7802 </dd> 7803 7804 <!-- OBJECT METHODS --> 7805 <dd style="display: none; "> 7806 <div></div> 7807 </dd> 7808 7809 <!-- OBJECT EVENT FIELDS --> 7810 <dd style="display: none; "> 7811 <div></div> 7812 </dd> 7813 7814 <!-- FUNCTION PARAMETERS --> 7815 <dd style="display: none; "> 7816 <div></div> 7817 </dd> 7818 7819 </div> 7820 </div><div> 7821 <div> 7822 <dt> 7823 <var>windowId</var> 7824 <em> 7825 7826 <!-- TYPE --> 7827 <div style="display:inline"> 7828 ( 7829 <span class="optional" style="display: none; ">optional</span> 7830 <span class="enum" style="display: none; ">enumerated</span> 7831 <span id="typeTemplate"> 7832 <span style="display: none; "> 7833 <a> Type</a> 7834 </span> 7835 <span> 7836 <span style="display: none; "> 7837 array of <span><span></span></span> 7838 </span> 7839 <span>integer</span> 7840 <span style="display: none; "></span> 7841 </span> 7842 </span> 7843 ) 7844 </div> 7845 7846 </em> 7847 </dt> 7848 <dd class="todo" style="display: none; "> 7849 Undocumented. 7850 </dd> 7851 <dd>The ID of the window the tab is contained within.</dd> 7852 <dd style="display: none; "> 7853 This parameter was added in version 7854 <b><span></span></b>. 7855 You must omit this parameter in earlier versions, 7856 and you may omit it in any version. If you require this 7857 parameter, the manifest key 7858 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7859 can ensure that your extension won't be run in an earlier browser version. 7860 </dd> 7861 7862 <!-- OBJECT PROPERTIES --> 7863 <dd style="display: none; "> 7864 <dl> 7865 <div> 7866 <div> 7867 </div> 7868 </div> 7869 </dl> 7870 </dd> 7871 7872 <!-- OBJECT METHODS --> 7873 <dd style="display: none; "> 7874 <div></div> 7875 </dd> 7876 7877 <!-- OBJECT EVENT FIELDS --> 7878 <dd style="display: none; "> 7879 <div></div> 7880 </dd> 7881 7882 <!-- FUNCTION PARAMETERS --> 7883 <dd style="display: none; "> 7884 <div></div> 7885 </dd> 7886 7887 </div> 7888 </div><div> 7889 <div> 7890 <dt> 7891 <var>selected</var> 7892 <em> 7893 7894 <!-- TYPE --> 7895 <div style="display:inline"> 7896 ( 7897 <span class="optional" style="display: none; ">optional</span> 7898 <span class="enum" style="display: none; ">enumerated</span> 7899 <span id="typeTemplate"> 7900 <span style="display: none; "> 7901 <a> Type</a> 7902 </span> 7903 <span> 7904 <span style="display: none; "> 7905 array of <span><span></span></span> 7906 </span> 7907 <span>boolean</span> 7908 <span style="display: none; "></span> 7909 </span> 7910 </span> 7911 ) 7912 </div> 7913 7914 </em> 7915 </dt> 7916 <dd class="todo" style="display: none; "> 7917 Undocumented. 7918 </dd> 7919 <dd>Whether the tab is selected.</dd> 7920 <dd style="display: none; "> 7921 This parameter was added in version 7922 <b><span></span></b>. 7923 You must omit this parameter in earlier versions, 7924 and you may omit it in any version. If you require this 7925 parameter, the manifest key 7926 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7927 can ensure that your extension won't be run in an earlier browser version. 7928 </dd> 7929 7930 <!-- OBJECT PROPERTIES --> 7931 <dd style="display: none; "> 7932 <dl> 7933 <div> 7934 <div> 7935 </div> 7936 </div> 7937 </dl> 7938 </dd> 7939 7940 <!-- OBJECT METHODS --> 7941 <dd style="display: none; "> 7942 <div></div> 7943 </dd> 7944 7945 <!-- OBJECT EVENT FIELDS --> 7946 <dd style="display: none; "> 7947 <div></div> 7948 </dd> 7949 7950 <!-- FUNCTION PARAMETERS --> 7951 <dd style="display: none; "> 7952 <div></div> 7953 </dd> 7954 7955 </div> 7956 </div><div> 7957 <div> 7958 <dt> 7959 <var>pinned</var> 7960 <em> 7961 7962 <!-- TYPE --> 7963 <div style="display:inline"> 7964 ( 7965 <span class="optional" style="display: none; ">optional</span> 7966 <span class="enum" style="display: none; ">enumerated</span> 7967 <span id="typeTemplate"> 7968 <span style="display: none; "> 7969 <a> Type</a> 7970 </span> 7971 <span> 7972 <span style="display: none; "> 7973 array of <span><span></span></span> 7974 </span> 7975 <span>boolean</span> 7976 <span style="display: none; "></span> 7977 </span> 7978 </span> 7979 ) 7980 </div> 7981 7982 </em> 7983 </dt> 7984 <dd class="todo" style="display: none; "> 7985 Undocumented. 7986 </dd> 7987 <dd>Whether the tab is pinned.</dd> 7988 <dd style="display: none; "> 7989 This parameter was added in version 7990 <b><span></span></b>. 7991 You must omit this parameter in earlier versions, 7992 and you may omit it in any version. If you require this 7993 parameter, the manifest key 7994 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 7995 can ensure that your extension won't be run in an earlier browser version. 7996 </dd> 7997 7998 <!-- OBJECT PROPERTIES --> 7999 <dd style="display: none; "> 8000 <dl> 8001 <div> 8002 <div> 8003 </div> 8004 </div> 8005 </dl> 8006 </dd> 8007 8008 <!-- OBJECT METHODS --> 8009 <dd style="display: none; "> 8010 <div></div> 8011 </dd> 8012 8013 <!-- OBJECT EVENT FIELDS --> 8014 <dd style="display: none; "> 8015 <div></div> 8016 </dd> 8017 8018 <!-- FUNCTION PARAMETERS --> 8019 <dd style="display: none; "> 8020 <div></div> 8021 </dd> 8022 8023 </div> 8024 </div><div> 8025 <div> 8026 <dt> 8027 <var>url</var> 8028 <em> 8029 8030 <!-- TYPE --> 8031 <div style="display:inline"> 8032 ( 8033 <span class="optional" style="display: none; ">optional</span> 8034 <span class="enum" style="display: none; ">enumerated</span> 8035 <span id="typeTemplate"> 8036 <span style="display: none; "> 8037 <a> Type</a> 8038 </span> 8039 <span> 8040 <span style="display: none; "> 8041 array of <span><span></span></span> 8042 </span> 8043 <span>string</span> 8044 <span style="display: none; "></span> 8045 </span> 8046 </span> 8047 ) 8048 </div> 8049 8050 </em> 8051 </dt> 8052 <dd class="todo" style="display: none; "> 8053 Undocumented. 8054 </dd> 8055 <dd>The URL the tab is displaying.</dd> 8056 <dd style="display: none; "> 8057 This parameter was added in version 8058 <b><span></span></b>. 8059 You must omit this parameter in earlier versions, 8060 and you may omit it in any version. If you require this 8061 parameter, the manifest key 8062 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 8063 can ensure that your extension won't be run in an earlier browser version. 8064 </dd> 8065 8066 <!-- OBJECT PROPERTIES --> 8067 <dd style="display: none; "> 8068 <dl> 8069 <div> 8070 <div> 8071 </div> 8072 </div> 8073 </dl> 8074 </dd> 8075 8076 <!-- OBJECT METHODS --> 8077 <dd style="display: none; "> 8078 <div></div> 8079 </dd> 8080 8081 <!-- OBJECT EVENT FIELDS --> 8082 <dd style="display: none; "> 8083 <div></div> 8084 </dd> 8085 8086 <!-- FUNCTION PARAMETERS --> 8087 <dd style="display: none; "> 8088 <div></div> 8089 </dd> 8090 8091 </div> 8092 </div><div> 8093 <div> 8094 <dt> 8095 <var>title</var> 8096 <em> 8097 8098 <!-- TYPE --> 8099 <div style="display:inline"> 8100 ( 8101 <span class="optional">optional</span> 8102 <span class="enum" style="display: none; ">enumerated</span> 8103 <span id="typeTemplate"> 8104 <span style="display: none; "> 8105 <a> Type</a> 8106 </span> 8107 <span> 8108 <span style="display: none; "> 8109 array of <span><span></span></span> 8110 </span> 8111 <span>string</span> 8112 <span style="display: none; "></span> 8113 </span> 8114 </span> 8115 ) 8116 </div> 8117 8118 </em> 8119 </dt> 8120 <dd class="todo" style="display: none; "> 8121 Undocumented. 8122 </dd> 8123 <dd>The title of the tab. This may not be available if the tab is loading.</dd> 8124 <dd style="display: none; "> 8125 This parameter was added in version 8126 <b><span></span></b>. 8127 You must omit this parameter in earlier versions, 8128 and you may omit it in any version. If you require this 8129 parameter, the manifest key 8130 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 8131 can ensure that your extension won't be run in an earlier browser version. 8132 </dd> 8133 8134 <!-- OBJECT PROPERTIES --> 8135 <dd style="display: none; "> 8136 <dl> 8137 <div> 8138 <div> 8139 </div> 8140 </div> 8141 </dl> 8142 </dd> 8143 8144 <!-- OBJECT METHODS --> 8145 <dd style="display: none; "> 8146 <div></div> 8147 </dd> 8148 8149 <!-- OBJECT EVENT FIELDS --> 8150 <dd style="display: none; "> 8151 <div></div> 8152 </dd> 8153 8154 <!-- FUNCTION PARAMETERS --> 8155 <dd style="display: none; "> 8156 <div></div> 8157 </dd> 8158 8159 </div> 8160 </div><div> 8161 <div> 8162 <dt> 8163 <var>favIconUrl</var> 8164 <em> 8165 8166 <!-- TYPE --> 8167 <div style="display:inline"> 8168 ( 8169 <span class="optional">optional</span> 8170 <span class="enum" style="display: none; ">enumerated</span> 8171 <span id="typeTemplate"> 8172 <span style="display: none; "> 8173 <a> Type</a> 8174 </span> 8175 <span> 8176 <span style="display: none; "> 8177 array of <span><span></span></span> 8178 </span> 8179 <span>string</span> 8180 <span style="display: none; "></span> 8181 </span> 8182 </span> 8183 ) 8184 </div> 8185 8186 </em> 8187 </dt> 8188 <dd class="todo" style="display: none; "> 8189 Undocumented. 8190 </dd> 8191 <dd>The URL of the tab's favicon. This may not be available if the tab is loading.</dd> 8192 <dd style="display: none; "> 8193 This parameter was added in version 8194 <b><span></span></b>. 8195 You must omit this parameter in earlier versions, 8196 and you may omit it in any version. If you require this 8197 parameter, the manifest key 8198 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 8199 can ensure that your extension won't be run in an earlier browser version. 8200 </dd> 8201 8202 <!-- OBJECT PROPERTIES --> 8203 <dd style="display: none; "> 8204 <dl> 8205 <div> 8206 <div> 8207 </div> 8208 </div> 8209 </dl> 8210 </dd> 8211 8212 <!-- OBJECT METHODS --> 8213 <dd style="display: none; "> 8214 <div></div> 8215 </dd> 8216 8217 <!-- OBJECT EVENT FIELDS --> 8218 <dd style="display: none; "> 8219 <div></div> 8220 </dd> 8221 8222 <!-- FUNCTION PARAMETERS --> 8223 <dd style="display: none; "> 8224 <div></div> 8225 </dd> 8226 8227 </div> 8228 </div><div> 8229 <div> 8230 <dt> 8231 <var>status</var> 8232 <em> 8233 8234 <!-- TYPE --> 8235 <div style="display:inline"> 8236 ( 8237 <span class="optional">optional</span> 8238 <span class="enum" style="display: none; ">enumerated</span> 8239 <span id="typeTemplate"> 8240 <span style="display: none; "> 8241 <a> Type</a> 8242 </span> 8243 <span> 8244 <span style="display: none; "> 8245 array of <span><span></span></span> 8246 </span> 8247 <span>string</span> 8248 <span style="display: none; "></span> 8249 </span> 8250 </span> 8251 ) 8252 </div> 8253 8254 </em> 8255 </dt> 8256 <dd class="todo" style="display: none; "> 8257 Undocumented. 8258 </dd> 8259 <dd>Either <em>loading</em> or <em>complete</em>.</dd> 8260 <dd style="display: none; "> 8261 This parameter was added in version 8262 <b><span></span></b>. 8263 You must omit this parameter in earlier versions, 8264 and you may omit it in any version. If you require this 8265 parameter, the manifest key 8266 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 8267 can ensure that your extension won't be run in an earlier browser version. 8268 </dd> 8269 8270 <!-- OBJECT PROPERTIES --> 8271 <dd style="display: none; "> 8272 <dl> 8273 <div> 8274 <div> 8275 </div> 8276 </div> 8277 </dl> 8278 </dd> 8279 8280 <!-- OBJECT METHODS --> 8281 <dd style="display: none; "> 8282 <div></div> 8283 </dd> 8284 8285 <!-- OBJECT EVENT FIELDS --> 8286 <dd style="display: none; "> 8287 <div></div> 8288 </dd> 8289 8290 <!-- FUNCTION PARAMETERS --> 8291 <dd style="display: none; "> 8292 <div></div> 8293 </dd> 8294 8295 </div> 8296 </div><div> 8297 <div> 8298 <dt> 8299 <var>incognito</var> 8300 <em> 8301 8302 <!-- TYPE --> 8303 <div style="display:inline"> 8304 ( 8305 <span class="optional" style="display: none; ">optional</span> 8306 <span class="enum" style="display: none; ">enumerated</span> 8307 <span id="typeTemplate"> 8308 <span style="display: none; "> 8309 <a> Type</a> 8310 </span> 8311 <span> 8312 <span style="display: none; "> 8313 array of <span><span></span></span> 8314 </span> 8315 <span>boolean</span> 8316 <span style="display: none; "></span> 8317 </span> 8318 </span> 8319 ) 8320 </div> 8321 8322 </em> 8323 </dt> 8324 <dd class="todo" style="display: none; "> 8325 Undocumented. 8326 </dd> 8327 <dd>Whether the tab is in an incognito window.</dd> 8328 <dd style="display: none; "> 8329 This parameter was added in version 8330 <b><span></span></b>. 8331 You must omit this parameter in earlier versions, 8332 and you may omit it in any version. If you require this 8333 parameter, the manifest key 8334 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 8335 can ensure that your extension won't be run in an earlier browser version. 8336 </dd> 8337 8338 <!-- OBJECT PROPERTIES --> 8339 <dd style="display: none; "> 8340 <dl> 8341 <div> 8342 <div> 8343 </div> 8344 </div> 8345 </dl> 8346 </dd> 8347 8348 <!-- OBJECT METHODS --> 8349 <dd style="display: none; "> 8350 <div></div> 8351 </dd> 8352 8353 <!-- OBJECT EVENT FIELDS --> 8354 <dd style="display: none; "> 8355 <div></div> 8356 </dd> 8357 8358 <!-- FUNCTION PARAMETERS --> 8359 <dd style="display: none; "> 8360 <div></div> 8361 </dd> 8362 8363 </div> 8364 </div> 8365 </dl> 8366 </dd> 8367 8368 <!-- OBJECT METHODS --> 8369 <dd style="display: none; "> 8370 <div></div> 8371 </dd> 8372 8373 <!-- OBJECT EVENT FIELDS --> 8374 <dd style="display: none; "> 8375 <div></div> 8376 </dd> 8377 8378 <!-- FUNCTION PARAMETERS --> 8379 <dd style="display: none; "> 8380 <div></div> 8381 </dd> 8382 8383 </div> 8384 8385 </div> <!-- /apiItem --> 8386 8387 </div> <!-- /apiGroup --> 8388 8389 </div> <!-- /apiPage --> 8390 </div> <!-- /gc-pagecontent --> 8391 </div> <!-- /g-section --> 8392 </div> <!-- /codesiteContent --> 8393 <div id="gc-footer" --=""> 8394 <div class="text"> 8395 <p> 8396 Except as otherwise <a href="http://code.google.com/policies.html#restrictions">noted</a>, 8397 the content of this page is licensed under the <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons 8398 Attribution 3.0 License</a>, and code samples are licensed under the 8399 <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD License</a>. 8400 </p> 8401 <p> 8402 2011 Google 8403 </p> 8404 8405 <!-- begin analytics --> 8406 <script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> 8407 <script src="http://www.google-analytics.com/ga.js" type="text/javascript"></script> 8408 8409 <script type="text/javascript"> 8410 // chrome doc tracking 8411 try { 8412 var engdocs = _gat._getTracker("YT-10763712-2"); 8413 engdocs._trackPageview(); 8414 } catch(err) {} 8415 8416 // code.google.com site-wide tracking 8417 try { 8418 _uacct="UA-18071-1"; 8419 _uanchor=1; 8420 _uff=0; 8421 urchinTracker(); 8422 } 8423 catch(e) {/* urchinTracker not available. */} 8424 </script> 8425 <!-- end analytics --> 8426 </div> 8427 </div> <!-- /gc-footer --> 8428 </div> <!-- /gc-container --> 8429 </body></html> 8430
