windows.html revision 3f50c38dc070f4bb515c1b64450dae14f316474e
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>Windows - 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 <!-- FUNCTION PARAMETERS --> 85 <dd> 86 <div></div> 87 </dd> 88 89 </div> <!-- /VALUE --> 90 91 <div id="functionParametersTemplate"> 92 <h5>Parameters</h5> 93 <dl> 94 <div> 95 <div> 96 </div> 97 </div> 98 </dl> 99 </div> 100 </div> <!-- /SUBTEMPLATES --> 101 102 <a id="top"></a> 103 <div id="skipto"> 104 <a href="#gc-pagecontent">Skip to page content</a> 105 <a href="#gc-toc">Skip to main navigation</a> 106 </div> 107 <!-- API HEADER --> 108 <table id="header" width="100%" cellspacing="0" border="0"> 109 <tbody><tr> 110 <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> 111 <td valign="middle" width="100%" style="padding-left:0.6em;"> 112 <form action="http://www.google.com/cse" id="cse" style="margin-top:0.5em"> 113 <div id="gsc-search-box"> 114 <input type="hidden" name="cx" value="002967670403910741006:61_cvzfqtno"> 115 <input type="hidden" name="ie" value="UTF-8"> 116 <input type="text" name="q" value="" size="55"> 117 <input class="gsc-search-button" type="submit" name="sa" value="Search"> 118 <br> 119 <span class="greytext">e.g. "page action" or "tabs"</span> 120 </div> 121 </form> 122 123 <script type="text/javascript" src="http://www.google.com/jsapi"></script> 124 <script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script> 125 <script type="text/javascript" src="http://www.google.com/coop/cse/t13n?form=cse&t13n_langs=en"></script> 126 <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse&lang=en"></script> 127 </td> 128 </tr> 129 </tbody></table> 130 131 <div id="codesiteContent" class=""> 132 133 <a id="gc-topnav-anchor"></a> 134 <div id="gc-topnav"> 135 <h1>Google Chrome Extensions (<a href="http://code.google.com/labs/">Labs</a>)</h1> 136 <ul id="home" class="gc-topnav-tabs"> 137 <li id="home_link"> 138 <a href="index.html" title="Google Chrome Extensions home page">Home</a> 139 </li> 140 <li id="docs_link"> 141 <a href="docs.html" title="Official Google Chrome Extensions documentation">Docs</a> 142 </li> 143 <li id="faq_link"> 144 <a href="faq.html" title="Answers to frequently asked questions about Google Chrome Extensions">FAQ</a> 145 </li> 146 <li id="samples_link"> 147 <a href="samples.html" title="Sample extensions (with source code)">Samples</a> 148 </li> 149 <li id="group_link"> 150 <a href="http://groups.google.com/a/chromium.org/group/chromium-extensions" title="Google Chrome Extensions developer forum">Group</a> 151 </li> 152 </ul> 153 </div> <!-- end gc-topnav --> 154 155 <div class="g-section g-tpl-170"> 156 <!-- SIDENAV --> 157 <div class="g-unit g-first" id="gc-toc"> 158 <ul> 159 <li><a href="getstarted.html">Getting Started</a></li> 160 <li><a href="overview.html">Overview</a></li> 161 <li><a href="whats_new.html">What's New?</a></li> 162 <li><h2><a href="devguide.html">Developer's Guide</a></h2> 163 <ul> 164 <li>Browser UI 165 <ul> 166 <li><a href="browserAction.html">Browser Actions</a></li> 167 <li><a href="contextMenus.html">Context Menus</a></li> 168 <li><a href="notifications.html">Desktop Notifications</a></li> 169 <li><a href="omnibox.html">Omnibox</a></li> 170 <li><a href="options.html">Options Pages</a></li> 171 <li><a href="override.html">Override Pages</a></li> 172 <li><a href="pageAction.html">Page Actions</a></li> 173 </ul> 174 </li> 175 <li>Browser Interaction 176 <ul> 177 <li><a href="bookmarks.html">Bookmarks</a></li> 178 <li><a href="cookies.html">Cookies</a></li> 179 <li><a href="events.html">Events</a></li> 180 <li><a href="history.html">History</a></li> 181 <li><a href="management.html">Management</a></li> 182 <li><a href="tabs.html">Tabs</a></li> 183 <li class="leftNavSelected">Windows</li> 184 </ul> 185 </li> 186 <li>Implementation 187 <ul> 188 <li><a href="a11y.html">Accessibility</a></li> 189 <li><a href="background_pages.html">Background Pages</a></li> 190 <li><a href="content_scripts.html">Content Scripts</a></li> 191 <li><a href="xhr.html">Cross-Origin XHR</a></li> 192 <li><a href="idle.html">Idle</a></li> 193 <li><a href="i18n.html">Internationalization</a></li> 194 <li><a href="messaging.html">Message Passing</a></li> 195 <li><a href="npapi.html">NPAPI Plugins</a></li> 196 </ul> 197 </li> 198 <li>Finishing 199 <ul> 200 <li><a href="hosting.html">Hosting</a></li> 201 <li><a href="external_extensions.html">Other Deployment Options</a></li> 202 </ul> 203 </li> 204 </ul> 205 </li> 206 <li><h2><a href="apps.html">Packaged Apps</a></h2></li> 207 <li><h2><a href="tutorials.html">Tutorials</a></h2> 208 <ul> 209 <li><a href="tut_debugging.html">Debugging</a></li> 210 <li><a href="tut_analytics.html">Google Analytics</a></li> 211 <li><a href="tut_oauth.html">OAuth</a></li> 212 </ul> 213 </li> 214 <li><h2>Reference</h2> 215 <ul> 216 <li>Formats 217 <ul> 218 <li><a href="manifest.html">Manifest Files</a></li> 219 <li><a href="match_patterns.html">Match Patterns</a></li> 220 </ul> 221 </li> 222 <li><a href="permission_warnings.html">Permission Warnings</a></li> 223 <li><a href="api_index.html">chrome.* APIs</a></li> 224 <li><a href="api_other.html">Other APIs</a></li> 225 </ul> 226 </li> 227 <li><h2><a href="samples.html">Samples</a></h2></li> 228 <div class="line"> </div> 229 <li><h2>More</h2> 230 <ul> 231 <li><a href="http://code.google.com/chrome/webstore/docs/index.html">Chrome Web Store</a></li> 232 <li><a href="http://code.google.com/chrome/apps/docs/developers_guide.html">Hosted Apps</a></li> 233 <li><a href="themes.html">Themes</a></li> 234 </ul> 235 </li> 236 </ul> 237 </div> 238 <script> 239 initToggles(); 240 </script> 241 242 <div class="g-unit" id="gc-pagecontent"> 243 <div id="pageTitle"> 244 <h1 class="page_title">Windows</h1> 245 </div> 246 <!-- TABLE OF CONTENTS --> 247 <div id="toc"> 248 <h2>Contents</h2> 249 <ol> 250 <li> 251 <a href="#manifest">Manifest</a> 252 <ol> 253 <li style="display: none; "> 254 <a>h3Name</a> 255 </li> 256 </ol> 257 </li><li> 258 <a href="#current-window">The current window</a> 259 <ol> 260 <li style="display: none; "> 261 <a>h3Name</a> 262 </li> 263 </ol> 264 </li><li> 265 <a href="#examples"> Examples </a> 266 <ol> 267 <li style="display: none; "> 268 <a>h3Name</a> 269 </li> 270 </ol> 271 </li> 272 <li> 273 <a href="#apiReference">API reference: chrome.windows</a> 274 <ol> 275 <li> 276 <a href="#properties">Properties</a> 277 <ol> 278 <li> 279 <a href="#property-WINDOW_ID_NONE">WINDOW_ID_NONE</a> 280 </li> 281 </ol> 282 </li> 283 <li> 284 <a href="#methods">Methods</a> 285 <ol> 286 <li> 287 <a href="#method-create">create</a> 288 </li><li> 289 <a href="#method-get">get</a> 290 </li><li> 291 <a href="#method-getAll">getAll</a> 292 </li><li> 293 <a href="#method-getCurrent">getCurrent</a> 294 </li><li> 295 <a href="#method-getLastFocused">getLastFocused</a> 296 </li><li> 297 <a href="#method-remove">remove</a> 298 </li><li> 299 <a href="#method-update">update</a> 300 </li> 301 </ol> 302 </li> 303 <li> 304 <a href="#events">Events</a> 305 <ol> 306 <li> 307 <a href="#event-onCreated">onCreated</a> 308 </li><li> 309 <a href="#event-onFocusChanged">onFocusChanged</a> 310 </li><li> 311 <a href="#event-onRemoved">onRemoved</a> 312 </li> 313 </ol> 314 </li> 315 <li> 316 <a href="#types">Types</a> 317 <ol> 318 <li> 319 <a href="#type-Window">Window</a> 320 </li> 321 </ol> 322 </li> 323 </ol> 324 </li> 325 </ol> 326 </div> 327 <!-- /TABLE OF CONTENTS --> 328 329 <!-- Standard content lead-in for experimental API pages --> 330 <p id="classSummary" style="display: none; "> 331 For information on how to use experimental APIs, see the <a href="experimental.html">chrome.experimental.* APIs</a> page. 332 </p> 333 334 <!-- STATIC CONTENT PLACEHOLDER --> 335 <div id="static"><div id="pageData-name" class="pageData">Windows</div> 336 337<!-- BEGIN AUTHORED CONTENT --> 338<p id="classSummary"> 339Use the <code>chrome.windows</code> module 340to interact with browser windows. 341You can use this module to 342create, modify, and rearrange windows in the browser. 343</p> 344 345<img src="images/windows.png" width="256" height="76" alt="Two windows, each with one tab"> 346 347<h2 id="manifest">Manifest</h2> 348<p> 349To use the windows API, 350you must declare the "tabs" permission 351in <a href="manifest.html">manifest.json</a>. 352(No, that isn't a typo — 353the window and tabs modules interact so closely we 354decided to just share one permission between them.) 355For example: 356</p> 357 358<pre>{ 359 "name": "My extension", 360 ... 361 <b>"permissions": ["tabs"]</b>, 362 ... 363}</pre> 364 365<h2 id="current-window">The current window</h2> 366 367<p>Many functions in the extension system 368take an optional <var>windowId</var> parameter, 369which defaults to the current window. 370</p> 371 372<p>The <em>current window</em> is the window that 373contains the code that is currently executing. 374It's important to realize that this can be 375different from the topmost or focused window. 376</p> 377 378<p>For example, say an extension 379creates a few tabs or windows from a single HTML file, 380and that the HTML file 381contains a call to 382<a href="tabs.html#method-getSelected">chrome.tabs.getSelected</a>. 383The current window is the window that contains the page that made 384the call, no matter what the topmost window is. 385</p> 386 387<p>In the case of the <a href="background_pages.html">background page</a>, 388the value of the current window falls back to the last active window. Under some 389circumstances, there may be no current window for background pages. 390</p> 391 392<h2 id="examples"> Examples </h2> 393 394<p> 395You can find simple examples of using the windows module in the 396<a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/windows/">examples/api/windows</a> 397directory. 398Another example is in the 399<a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/tabs/inspector/tabs_api.html?content-type=text/plain">tabs_api.html</a> file 400of the 401<a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/tabs/inspector/">inspector</a> 402example. 403For other examples and for help in viewing the source code, see 404<a href="samples.html">Samples</a>. 405</p> 406 407<!-- END AUTHORED CONTENT --> 408</div> 409 410 <!-- API PAGE --> 411 <div class="apiPage"> 412 <a name="apiReference"></a> 413 <h2>API reference: chrome.windows</h2> 414 415 <!-- PROPERTIES --> 416 <div class="apiGroup"> 417 <a name="properties"></a> 418 <h3 id="properties">Properties</h3> 419 420 <div> 421 <a name="property-WINDOW_ID_NONE"></a> 422 <h4>WINDOW_ID_NONE</h4> 423 <div class="summary"> 424 <!-- Note: intentionally longer 80 columns --> 425 <span>chrome.windows.</span><span>WINDOW_ID_NONE</span> 426 </div> 427 <div> 428 <dt> 429 <var>WINDOW_ID_NONE</var> 430 <em> 431 432 <!-- TYPE --> 433 <div style="display:inline"> 434 ( 435 <span class="optional" style="display: none; ">optional</span> 436 <span class="enum" style="display: none; ">enumerated</span> 437 <span id="typeTemplate"> 438 <span style="display: none; "> 439 <a> Type</a> 440 </span> 441 <span> 442 <span style="display: none; "> 443 array of <span><span></span></span> 444 </span> 445 <span>integer</span> 446 <span style="display: none; "></span> 447 </span> 448 </span> 449 ) 450 </div> 451 452 </em> 453 </dt> 454 <dd class="todo" style="display: none; "> 455 Undocumented. 456 </dd> 457 <dd>The windowId value that represents the absence of a chrome browser window.</dd> 458 <dd style="display: none; "> 459 This parameter was added in version 460 <b><span></span></b>. 461 You must omit this parameter in earlier versions, 462 and you may omit it in any version. If you require this 463 parameter, the manifest key 464 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 465 can ensure that your extension won't be run in an earlier browser version. 466 </dd> 467 468 <!-- OBJECT PROPERTIES --> 469 <dd style="display: none; "> 470 <dl> 471 <div> 472 <div> 473 </div> 474 </div> 475 </dl> 476 </dd> 477 478 <!-- FUNCTION PARAMETERS --> 479 <dd style="display: none; "> 480 <div></div> 481 </dd> 482 483 </div> 484 </div> 485 486 </div> <!-- /apiGroup --> 487 488 <!-- METHODS --> 489 <div class="apiGroup" id="methods"> 490 <a name="methods"></a> 491 <h3>Methods</h3> 492 493 <!-- iterates over all functions --> 494 <div class="apiItem"> 495 <a name="method-create"></a> <!-- method-anchor --> 496 <h4>create</h4> 497 498 <div class="summary"><span style="display: none; ">void</span> 499 <!-- Note: intentionally longer 80 columns --> 500 <span>chrome.windows.create</span>(<span class="optional"><span style="display: none; ">, </span><span>object</span> 501 <var><span>createData</span></var></span><span class="optional"><span>, </span><span>function</span> 502 <var><span>callback</span></var></span>)</div> 503 504 <div class="description"> 505 <p class="todo" style="display: none; ">Undocumented.</p> 506 <p>Creates (opens) a new browser with any optional sizing, position or default URL provided.</p> 507 508 <!-- PARAMETERS --> 509 <h4>Parameters</h4> 510 <dl> 511 <div> 512 <div> 513 <dt> 514 <var>createData</var> 515 <em> 516 517 <!-- TYPE --> 518 <div style="display:inline"> 519 ( 520 <span class="optional">optional</span> 521 <span class="enum" style="display: none; ">enumerated</span> 522 <span id="typeTemplate"> 523 <span style="display: none; "> 524 <a> Type</a> 525 </span> 526 <span> 527 <span style="display: none; "> 528 array of <span><span></span></span> 529 </span> 530 <span>object</span> 531 <span style="display: none; "></span> 532 </span> 533 </span> 534 ) 535 </div> 536 537 </em> 538 </dt> 539 <dd class="todo"> 540 Undocumented. 541 </dd> 542 <dd style="display: none; "> 543 Description of this parameter from the json schema. 544 </dd> 545 <dd style="display: none; "> 546 This parameter was added in version 547 <b><span></span></b>. 548 You must omit this parameter in earlier versions, 549 and you may omit it in any version. If you require this 550 parameter, the manifest key 551 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 552 can ensure that your extension won't be run in an earlier browser version. 553 </dd> 554 555 <!-- OBJECT PROPERTIES --> 556 <dd> 557 <dl> 558 <div> 559 <div> 560 <dt> 561 <var>url</var> 562 <em> 563 564 <!-- TYPE --> 565 <div style="display:inline"> 566 ( 567 <span class="optional">optional</span> 568 <span class="enum" style="display: none; ">enumerated</span> 569 <span id="typeTemplate"> 570 <span style="display: none; "> 571 <a> Type</a> 572 </span> 573 <span> 574 <span style="display: none; "> 575 array of <span><span></span></span> 576 </span> 577 <span>string or array of string</span> 578 <span style="display: none; "></span> 579 </span> 580 </span> 581 ) 582 </div> 583 584 </em> 585 </dt> 586 <dd class="todo" style="display: none; "> 587 Undocumented. 588 </dd> 589 <dd>A URL or list of URLs to open as tabs in the window. 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> 590 <dd style="display: none; "> 591 This parameter was added in version 592 <b><span></span></b>. 593 You must omit this parameter in earlier versions, 594 and you may omit it in any version. If you require this 595 parameter, the manifest key 596 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 597 can ensure that your extension won't be run in an earlier browser version. 598 </dd> 599 600 <!-- OBJECT PROPERTIES --> 601 <dd style="display: none; "> 602 <dl> 603 <div> 604 <div> 605 </div> 606 </div> 607 </dl> 608 </dd> 609 610 <!-- FUNCTION PARAMETERS --> 611 <dd style="display: none; "> 612 <div></div> 613 </dd> 614 615 </div> 616 </div><div> 617 <div> 618 <dt> 619 <var>tabId</var> 620 <em> 621 622 <!-- TYPE --> 623 <div style="display:inline"> 624 ( 625 <span class="optional">optional</span> 626 <span class="enum" style="display: none; ">enumerated</span> 627 <span id="typeTemplate"> 628 <span style="display: none; "> 629 <a> Type</a> 630 </span> 631 <span> 632 <span style="display: none; "> 633 array of <span><span></span></span> 634 </span> 635 <span>integer</span> 636 <span style="display: none; "></span> 637 </span> 638 </span> 639 ) 640 </div> 641 642 </em> 643 </dt> 644 <dd class="todo" style="display: none; "> 645 Undocumented. 646 </dd> 647 <dd>The id of the tab for which you want to adopt to the new window.</dd> 648 <dd style="display: none; "> 649 This parameter was added in version 650 <b><span></span></b>. 651 You must omit this parameter in earlier versions, 652 and you may omit it in any version. If you require this 653 parameter, the manifest key 654 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 655 can ensure that your extension won't be run in an earlier browser version. 656 </dd> 657 658 <!-- OBJECT PROPERTIES --> 659 <dd style="display: none; "> 660 <dl> 661 <div> 662 <div> 663 </div> 664 </div> 665 </dl> 666 </dd> 667 668 <!-- FUNCTION PARAMETERS --> 669 <dd style="display: none; "> 670 <div></div> 671 </dd> 672 673 </div> 674 </div><div> 675 <div> 676 <dt> 677 <var>left</var> 678 <em> 679 680 <!-- TYPE --> 681 <div style="display:inline"> 682 ( 683 <span class="optional">optional</span> 684 <span class="enum" style="display: none; ">enumerated</span> 685 <span id="typeTemplate"> 686 <span style="display: none; "> 687 <a> Type</a> 688 </span> 689 <span> 690 <span style="display: none; "> 691 array of <span><span></span></span> 692 </span> 693 <span>integer</span> 694 <span style="display: none; "></span> 695 </span> 696 </span> 697 ) 698 </div> 699 700 </em> 701 </dt> 702 <dd class="todo" style="display: none; "> 703 Undocumented. 704 </dd> 705 <dd>The number of pixels to position the new window from the left edge of the screen. If not specified, the new window is offset naturally from the last focusd window.</dd> 706 <dd style="display: none; "> 707 This parameter was added in version 708 <b><span></span></b>. 709 You must omit this parameter in earlier versions, 710 and you may omit it in any version. If you require this 711 parameter, the manifest key 712 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 713 can ensure that your extension won't be run in an earlier browser version. 714 </dd> 715 716 <!-- OBJECT PROPERTIES --> 717 <dd style="display: none; "> 718 <dl> 719 <div> 720 <div> 721 </div> 722 </div> 723 </dl> 724 </dd> 725 726 <!-- FUNCTION PARAMETERS --> 727 <dd style="display: none; "> 728 <div></div> 729 </dd> 730 731 </div> 732 </div><div> 733 <div> 734 <dt> 735 <var>top</var> 736 <em> 737 738 <!-- TYPE --> 739 <div style="display:inline"> 740 ( 741 <span class="optional">optional</span> 742 <span class="enum" style="display: none; ">enumerated</span> 743 <span id="typeTemplate"> 744 <span style="display: none; "> 745 <a> Type</a> 746 </span> 747 <span> 748 <span style="display: none; "> 749 array of <span><span></span></span> 750 </span> 751 <span>integer</span> 752 <span style="display: none; "></span> 753 </span> 754 </span> 755 ) 756 </div> 757 758 </em> 759 </dt> 760 <dd class="todo" style="display: none; "> 761 Undocumented. 762 </dd> 763 <dd>The number of pixels to position the new window from the top edge of the screen. If not specified, the new window is offset naturally from the last focusd window.</dd> 764 <dd style="display: none; "> 765 This parameter was added in version 766 <b><span></span></b>. 767 You must omit this parameter in earlier versions, 768 and you may omit it in any version. If you require this 769 parameter, the manifest key 770 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 771 can ensure that your extension won't be run in an earlier browser version. 772 </dd> 773 774 <!-- OBJECT PROPERTIES --> 775 <dd style="display: none; "> 776 <dl> 777 <div> 778 <div> 779 </div> 780 </div> 781 </dl> 782 </dd> 783 784 <!-- FUNCTION PARAMETERS --> 785 <dd style="display: none; "> 786 <div></div> 787 </dd> 788 789 </div> 790 </div><div> 791 <div> 792 <dt> 793 <var>width</var> 794 <em> 795 796 <!-- TYPE --> 797 <div style="display:inline"> 798 ( 799 <span class="optional">optional</span> 800 <span class="enum" style="display: none; ">enumerated</span> 801 <span id="typeTemplate"> 802 <span style="display: none; "> 803 <a> Type</a> 804 </span> 805 <span> 806 <span style="display: none; "> 807 array of <span><span></span></span> 808 </span> 809 <span>integer</span> 810 <span style="display: none; "></span> 811 </span> 812 </span> 813 ) 814 </div> 815 816 </em> 817 </dt> 818 <dd class="todo" style="display: none; "> 819 Undocumented. 820 </dd> 821 <dd>The width in pixels of the new window. If not specified defaults to a natural width.</dd> 822 <dd style="display: none; "> 823 This parameter was added in version 824 <b><span></span></b>. 825 You must omit this parameter in earlier versions, 826 and you may omit it in any version. If you require this 827 parameter, the manifest key 828 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 829 can ensure that your extension won't be run in an earlier browser version. 830 </dd> 831 832 <!-- OBJECT PROPERTIES --> 833 <dd style="display: none; "> 834 <dl> 835 <div> 836 <div> 837 </div> 838 </div> 839 </dl> 840 </dd> 841 842 <!-- FUNCTION PARAMETERS --> 843 <dd style="display: none; "> 844 <div></div> 845 </dd> 846 847 </div> 848 </div><div> 849 <div> 850 <dt> 851 <var>height</var> 852 <em> 853 854 <!-- TYPE --> 855 <div style="display:inline"> 856 ( 857 <span class="optional">optional</span> 858 <span class="enum" style="display: none; ">enumerated</span> 859 <span id="typeTemplate"> 860 <span style="display: none; "> 861 <a> Type</a> 862 </span> 863 <span> 864 <span style="display: none; "> 865 array of <span><span></span></span> 866 </span> 867 <span>integer</span> 868 <span style="display: none; "></span> 869 </span> 870 </span> 871 ) 872 </div> 873 874 </em> 875 </dt> 876 <dd class="todo" style="display: none; "> 877 Undocumented. 878 </dd> 879 <dd>The height in pixels of the new window. If not specified defaults to a natural height.</dd> 880 <dd style="display: none; "> 881 This parameter was added in version 882 <b><span></span></b>. 883 You must omit this parameter in earlier versions, 884 and you may omit it in any version. If you require this 885 parameter, the manifest key 886 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 887 can ensure that your extension won't be run in an earlier browser version. 888 </dd> 889 890 <!-- OBJECT PROPERTIES --> 891 <dd style="display: none; "> 892 <dl> 893 <div> 894 <div> 895 </div> 896 </div> 897 </dl> 898 </dd> 899 900 <!-- FUNCTION PARAMETERS --> 901 <dd style="display: none; "> 902 <div></div> 903 </dd> 904 905 </div> 906 </div><div> 907 <div> 908 <dt> 909 <var>incognito</var> 910 <em> 911 912 <!-- TYPE --> 913 <div style="display:inline"> 914 ( 915 <span class="optional">optional</span> 916 <span class="enum" style="display: none; ">enumerated</span> 917 <span id="typeTemplate"> 918 <span style="display: none; "> 919 <a> Type</a> 920 </span> 921 <span> 922 <span style="display: none; "> 923 array of <span><span></span></span> 924 </span> 925 <span>boolean</span> 926 <span style="display: none; "></span> 927 </span> 928 </span> 929 ) 930 </div> 931 932 </em> 933 </dt> 934 <dd class="todo" style="display: none; "> 935 Undocumented. 936 </dd> 937 <dd>Whether the new window should be an incognito window.</dd> 938 <dd style="display: none; "> 939 This parameter was added in version 940 <b><span></span></b>. 941 You must omit this parameter in earlier versions, 942 and you may omit it in any version. If you require this 943 parameter, the manifest key 944 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 945 can ensure that your extension won't be run in an earlier browser version. 946 </dd> 947 948 <!-- OBJECT PROPERTIES --> 949 <dd style="display: none; "> 950 <dl> 951 <div> 952 <div> 953 </div> 954 </div> 955 </dl> 956 </dd> 957 958 <!-- FUNCTION PARAMETERS --> 959 <dd style="display: none; "> 960 <div></div> 961 </dd> 962 963 </div> 964 </div><div> 965 <div> 966 <dt> 967 <var>type</var> 968 <em> 969 970 <!-- TYPE --> 971 <div style="display:inline"> 972 ( 973 <span class="optional">optional</span> 974 <span class="enum">enumerated</span> 975 <span id="typeTemplate"> 976 <span style="display: none; "> 977 <a> Type</a> 978 </span> 979 <span> 980 <span style="display: none; "> 981 array of <span><span></span></span> 982 </span> 983 <span>string</span> 984 <span>["normal", "popup"]</span> 985 </span> 986 </span> 987 ) 988 </div> 989 990 </em> 991 </dt> 992 <dd class="todo" style="display: none; "> 993 Undocumented. 994 </dd> 995 <dd>Specifies what type of browser window to create.</dd> 996 <dd style="display: none; "> 997 This parameter was added in version 998 <b><span></span></b>. 999 You must omit this parameter in earlier versions, 1000 and you may omit it in any version. If you require this 1001 parameter, the manifest key 1002 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1003 can ensure that your extension won't be run in an earlier browser version. 1004 </dd> 1005 1006 <!-- OBJECT PROPERTIES --> 1007 <dd style="display: none; "> 1008 <dl> 1009 <div> 1010 <div> 1011 </div> 1012 </div> 1013 </dl> 1014 </dd> 1015 1016 <!-- FUNCTION PARAMETERS --> 1017 <dd style="display: none; "> 1018 <div></div> 1019 </dd> 1020 1021 </div> 1022 </div> 1023 </dl> 1024 </dd> 1025 1026 <!-- FUNCTION PARAMETERS --> 1027 <dd style="display: none; "> 1028 <div></div> 1029 </dd> 1030 1031 </div> 1032 </div><div> 1033 <div> 1034 <dt> 1035 <var>callback</var> 1036 <em> 1037 1038 <!-- TYPE --> 1039 <div style="display:inline"> 1040 ( 1041 <span class="optional">optional</span> 1042 <span class="enum" style="display: none; ">enumerated</span> 1043 <span id="typeTemplate"> 1044 <span style="display: none; "> 1045 <a> Type</a> 1046 </span> 1047 <span> 1048 <span style="display: none; "> 1049 array of <span><span></span></span> 1050 </span> 1051 <span>function</span> 1052 <span style="display: none; "></span> 1053 </span> 1054 </span> 1055 ) 1056 </div> 1057 1058 </em> 1059 </dt> 1060 <dd class="todo"> 1061 Undocumented. 1062 </dd> 1063 <dd style="display: none; "> 1064 Description of this parameter from the json schema. 1065 </dd> 1066 <dd style="display: none; "> 1067 This parameter was added in version 1068 <b><span></span></b>. 1069 You must omit this parameter in earlier versions, 1070 and you may omit it in any version. If you require this 1071 parameter, the manifest key 1072 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1073 can ensure that your extension won't be run in an earlier browser version. 1074 </dd> 1075 1076 <!-- OBJECT PROPERTIES --> 1077 <dd style="display: none; "> 1078 <dl> 1079 <div> 1080 <div> 1081 </div> 1082 </div> 1083 </dl> 1084 </dd> 1085 1086 <!-- FUNCTION PARAMETERS --> 1087 <dd style="display: none; "> 1088 <div></div> 1089 </dd> 1090 1091 </div> 1092 </div> 1093 </dl> 1094 1095 <!-- RETURNS --> 1096 <h4 style="display: none; ">Returns</h4> 1097 <dl> 1098 <div style="display: none; "> 1099 <div> 1100 </div> 1101 </div> 1102 </dl> 1103 1104 <!-- CALLBACK --> 1105 <div> 1106 <div> 1107 <h4>Callback function</h4> 1108 <p style="display: none; "> 1109 The callback <em>parameter</em> should specify a function 1110 that looks like this: 1111 </p> 1112 <p> 1113 If you specify the <em>callback</em> parameter, it should 1114 specify a function that looks like this: 1115 </p> 1116 1117 <!-- Note: intentionally longer 80 columns --> 1118 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 1119 <dl> 1120 <div> 1121 <div> 1122 <dt> 1123 <var>window</var> 1124 <em> 1125 1126 <!-- TYPE --> 1127 <div style="display:inline"> 1128 ( 1129 <span class="optional">optional</span> 1130 <span class="enum" style="display: none; ">enumerated</span> 1131 <span id="typeTemplate"> 1132 <span> 1133 <a href="windows.html#type-Window">Window</a> 1134 </span> 1135 <span style="display: none; "> 1136 <span> 1137 array of <span><span></span></span> 1138 </span> 1139 <span>paramType</span> 1140 <span></span> 1141 </span> 1142 </span> 1143 ) 1144 </div> 1145 1146 </em> 1147 </dt> 1148 <dd class="todo" style="display: none; "> 1149 Undocumented. 1150 </dd> 1151 <dd>Contains details about the created window.</dd> 1152 <dd style="display: none; "> 1153 This parameter was added in version 1154 <b><span></span></b>. 1155 You must omit this parameter in earlier versions, 1156 and you may omit it in any version. If you require this 1157 parameter, the manifest key 1158 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1159 can ensure that your extension won't be run in an earlier browser version. 1160 </dd> 1161 1162 <!-- OBJECT PROPERTIES --> 1163 <dd style="display: none; "> 1164 <dl> 1165 <div> 1166 <div> 1167 </div> 1168 </div> 1169 </dl> 1170 </dd> 1171 1172 <!-- FUNCTION PARAMETERS --> 1173 <dd style="display: none; "> 1174 <div></div> 1175 </dd> 1176 1177 </div> 1178 </div> 1179 </dl> 1180 </div> 1181 </div> 1182 1183 <!-- MIN_VERSION --> 1184 <p style="display: none; "> 1185 This function was added in version <b><span></span></b>. 1186 If you require this function, the manifest key 1187 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1188 can ensure that your extension won't be run in an earlier browser version. 1189 </p> 1190 </div> <!-- /description --> 1191 1192 </div><div class="apiItem"> 1193 <a name="method-get"></a> <!-- method-anchor --> 1194 <h4>get</h4> 1195 1196 <div class="summary"><span style="display: none; ">void</span> 1197 <!-- Note: intentionally longer 80 columns --> 1198 <span>chrome.windows.get</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 1199 <var><span>windowId</span></var></span><span class="null"><span>, </span><span>function</span> 1200 <var><span>callback</span></var></span>)</div> 1201 1202 <div class="description"> 1203 <p class="todo" style="display: none; ">Undocumented.</p> 1204 <p>Gets details about a window.</p> 1205 1206 <!-- PARAMETERS --> 1207 <h4>Parameters</h4> 1208 <dl> 1209 <div> 1210 <div> 1211 <dt> 1212 <var>windowId</var> 1213 <em> 1214 1215 <!-- TYPE --> 1216 <div style="display:inline"> 1217 ( 1218 <span class="optional" style="display: none; ">optional</span> 1219 <span class="enum" style="display: none; ">enumerated</span> 1220 <span id="typeTemplate"> 1221 <span style="display: none; "> 1222 <a> Type</a> 1223 </span> 1224 <span> 1225 <span style="display: none; "> 1226 array of <span><span></span></span> 1227 </span> 1228 <span>integer</span> 1229 <span style="display: none; "></span> 1230 </span> 1231 </span> 1232 ) 1233 </div> 1234 1235 </em> 1236 </dt> 1237 <dd class="todo"> 1238 Undocumented. 1239 </dd> 1240 <dd style="display: none; "> 1241 Description of this parameter from the json schema. 1242 </dd> 1243 <dd style="display: none; "> 1244 This parameter was added in version 1245 <b><span></span></b>. 1246 You must omit this parameter in earlier versions, 1247 and you may omit it in any version. If you require this 1248 parameter, the manifest key 1249 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1250 can ensure that your extension won't be run in an earlier browser version. 1251 </dd> 1252 1253 <!-- OBJECT PROPERTIES --> 1254 <dd style="display: none; "> 1255 <dl> 1256 <div> 1257 <div> 1258 </div> 1259 </div> 1260 </dl> 1261 </dd> 1262 1263 <!-- FUNCTION PARAMETERS --> 1264 <dd style="display: none; "> 1265 <div></div> 1266 </dd> 1267 1268 </div> 1269 </div><div> 1270 <div> 1271 <dt> 1272 <var>callback</var> 1273 <em> 1274 1275 <!-- TYPE --> 1276 <div style="display:inline"> 1277 ( 1278 <span class="optional" style="display: none; ">optional</span> 1279 <span class="enum" style="display: none; ">enumerated</span> 1280 <span id="typeTemplate"> 1281 <span style="display: none; "> 1282 <a> Type</a> 1283 </span> 1284 <span> 1285 <span style="display: none; "> 1286 array of <span><span></span></span> 1287 </span> 1288 <span>function</span> 1289 <span style="display: none; "></span> 1290 </span> 1291 </span> 1292 ) 1293 </div> 1294 1295 </em> 1296 </dt> 1297 <dd class="todo"> 1298 Undocumented. 1299 </dd> 1300 <dd style="display: none; "> 1301 Description of this parameter from the json schema. 1302 </dd> 1303 <dd style="display: none; "> 1304 This parameter was added in version 1305 <b><span></span></b>. 1306 You must omit this parameter in earlier versions, 1307 and you may omit it in any version. If you require this 1308 parameter, the manifest key 1309 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1310 can ensure that your extension won't be run in an earlier browser version. 1311 </dd> 1312 1313 <!-- OBJECT PROPERTIES --> 1314 <dd style="display: none; "> 1315 <dl> 1316 <div> 1317 <div> 1318 </div> 1319 </div> 1320 </dl> 1321 </dd> 1322 1323 <!-- FUNCTION PARAMETERS --> 1324 <dd style="display: none; "> 1325 <div></div> 1326 </dd> 1327 1328 </div> 1329 </div> 1330 </dl> 1331 1332 <!-- RETURNS --> 1333 <h4 style="display: none; ">Returns</h4> 1334 <dl> 1335 <div style="display: none; "> 1336 <div> 1337 </div> 1338 </div> 1339 </dl> 1340 1341 <!-- CALLBACK --> 1342 <div> 1343 <div> 1344 <h4>Callback function</h4> 1345 <p> 1346 The callback <em>parameter</em> should specify a function 1347 that looks like this: 1348 </p> 1349 <p style="display: none; "> 1350 If you specify the <em>callback</em> parameter, it should 1351 specify a function that looks like this: 1352 </p> 1353 1354 <!-- Note: intentionally longer 80 columns --> 1355 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 1356 <dl> 1357 <div> 1358 <div> 1359 <dt> 1360 <var>window</var> 1361 <em> 1362 1363 <!-- TYPE --> 1364 <div style="display:inline"> 1365 ( 1366 <span class="optional" style="display: none; ">optional</span> 1367 <span class="enum" style="display: none; ">enumerated</span> 1368 <span id="typeTemplate"> 1369 <span> 1370 <a href="windows.html#type-Window">Window</a> 1371 </span> 1372 <span style="display: none; "> 1373 <span> 1374 array of <span><span></span></span> 1375 </span> 1376 <span>paramType</span> 1377 <span></span> 1378 </span> 1379 </span> 1380 ) 1381 </div> 1382 1383 </em> 1384 </dt> 1385 <dd class="todo"> 1386 Undocumented. 1387 </dd> 1388 <dd style="display: none; "> 1389 Description of this parameter from the json schema. 1390 </dd> 1391 <dd style="display: none; "> 1392 This parameter was added in version 1393 <b><span></span></b>. 1394 You must omit this parameter in earlier versions, 1395 and you may omit it in any version. If you require this 1396 parameter, the manifest key 1397 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1398 can ensure that your extension won't be run in an earlier browser version. 1399 </dd> 1400 1401 <!-- OBJECT PROPERTIES --> 1402 <dd style="display: none; "> 1403 <dl> 1404 <div> 1405 <div> 1406 </div> 1407 </div> 1408 </dl> 1409 </dd> 1410 1411 <!-- FUNCTION PARAMETERS --> 1412 <dd style="display: none; "> 1413 <div></div> 1414 </dd> 1415 1416 </div> 1417 </div> 1418 </dl> 1419 </div> 1420 </div> 1421 1422 <!-- MIN_VERSION --> 1423 <p style="display: none; "> 1424 This function was added in version <b><span></span></b>. 1425 If you require this function, the manifest key 1426 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1427 can ensure that your extension won't be run in an earlier browser version. 1428 </p> 1429 </div> <!-- /description --> 1430 1431 </div><div class="apiItem"> 1432 <a name="method-getAll"></a> <!-- method-anchor --> 1433 <h4>getAll</h4> 1434 1435 <div class="summary"><span style="display: none; ">void</span> 1436 <!-- Note: intentionally longer 80 columns --> 1437 <span>chrome.windows.getAll</span>(<span class="optional"><span style="display: none; ">, </span><span>object</span> 1438 <var><span>getInfo</span></var></span><span class="null"><span>, </span><span>function</span> 1439 <var><span>callback</span></var></span>)</div> 1440 1441 <div class="description"> 1442 <p class="todo" style="display: none; ">Undocumented.</p> 1443 <p>Gets all windows.</p> 1444 1445 <!-- PARAMETERS --> 1446 <h4>Parameters</h4> 1447 <dl> 1448 <div> 1449 <div> 1450 <dt> 1451 <var>getInfo</var> 1452 <em> 1453 1454 <!-- TYPE --> 1455 <div style="display:inline"> 1456 ( 1457 <span class="optional">optional</span> 1458 <span class="enum" style="display: none; ">enumerated</span> 1459 <span id="typeTemplate"> 1460 <span style="display: none; "> 1461 <a> Type</a> 1462 </span> 1463 <span> 1464 <span style="display: none; "> 1465 array of <span><span></span></span> 1466 </span> 1467 <span>object</span> 1468 <span style="display: none; "></span> 1469 </span> 1470 </span> 1471 ) 1472 </div> 1473 1474 </em> 1475 </dt> 1476 <dd class="todo"> 1477 Undocumented. 1478 </dd> 1479 <dd style="display: none; "> 1480 Description of this parameter from the json schema. 1481 </dd> 1482 <dd style="display: none; "> 1483 This parameter was added in version 1484 <b><span></span></b>. 1485 You must omit this parameter in earlier versions, 1486 and you may omit it in any version. If you require this 1487 parameter, the manifest key 1488 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1489 can ensure that your extension won't be run in an earlier browser version. 1490 </dd> 1491 1492 <!-- OBJECT PROPERTIES --> 1493 <dd> 1494 <dl> 1495 <div> 1496 <div> 1497 <dt> 1498 <var>populate</var> 1499 <em> 1500 1501 <!-- TYPE --> 1502 <div style="display:inline"> 1503 ( 1504 <span class="optional">optional</span> 1505 <span class="enum" style="display: none; ">enumerated</span> 1506 <span id="typeTemplate"> 1507 <span style="display: none; "> 1508 <a> Type</a> 1509 </span> 1510 <span> 1511 <span style="display: none; "> 1512 array of <span><span></span></span> 1513 </span> 1514 <span>boolean</span> 1515 <span style="display: none; "></span> 1516 </span> 1517 </span> 1518 ) 1519 </div> 1520 1521 </em> 1522 </dt> 1523 <dd class="todo" style="display: none; "> 1524 Undocumented. 1525 </dd> 1526 <dd>If true, each window object will have a <var>tabs</var> property that contains a list of the <a href="tabs.html#type-Tab">Tab</a> objects for that window.</dd> 1527 <dd style="display: none; "> 1528 This parameter was added in version 1529 <b><span></span></b>. 1530 You must omit this parameter in earlier versions, 1531 and you may omit it in any version. If you require this 1532 parameter, the manifest key 1533 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1534 can ensure that your extension won't be run in an earlier browser version. 1535 </dd> 1536 1537 <!-- OBJECT PROPERTIES --> 1538 <dd style="display: none; "> 1539 <dl> 1540 <div> 1541 <div> 1542 </div> 1543 </div> 1544 </dl> 1545 </dd> 1546 1547 <!-- FUNCTION PARAMETERS --> 1548 <dd style="display: none; "> 1549 <div></div> 1550 </dd> 1551 1552 </div> 1553 </div> 1554 </dl> 1555 </dd> 1556 1557 <!-- FUNCTION PARAMETERS --> 1558 <dd style="display: none; "> 1559 <div></div> 1560 </dd> 1561 1562 </div> 1563 </div><div> 1564 <div> 1565 <dt> 1566 <var>callback</var> 1567 <em> 1568 1569 <!-- TYPE --> 1570 <div style="display:inline"> 1571 ( 1572 <span class="optional" style="display: none; ">optional</span> 1573 <span class="enum" style="display: none; ">enumerated</span> 1574 <span id="typeTemplate"> 1575 <span style="display: none; "> 1576 <a> Type</a> 1577 </span> 1578 <span> 1579 <span style="display: none; "> 1580 array of <span><span></span></span> 1581 </span> 1582 <span>function</span> 1583 <span style="display: none; "></span> 1584 </span> 1585 </span> 1586 ) 1587 </div> 1588 1589 </em> 1590 </dt> 1591 <dd class="todo"> 1592 Undocumented. 1593 </dd> 1594 <dd style="display: none; "> 1595 Description of this parameter from the json schema. 1596 </dd> 1597 <dd style="display: none; "> 1598 This parameter was added in version 1599 <b><span></span></b>. 1600 You must omit this parameter in earlier versions, 1601 and you may omit it in any version. If you require this 1602 parameter, the manifest key 1603 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1604 can ensure that your extension won't be run in an earlier browser version. 1605 </dd> 1606 1607 <!-- OBJECT PROPERTIES --> 1608 <dd style="display: none; "> 1609 <dl> 1610 <div> 1611 <div> 1612 </div> 1613 </div> 1614 </dl> 1615 </dd> 1616 1617 <!-- FUNCTION PARAMETERS --> 1618 <dd style="display: none; "> 1619 <div></div> 1620 </dd> 1621 1622 </div> 1623 </div> 1624 </dl> 1625 1626 <!-- RETURNS --> 1627 <h4 style="display: none; ">Returns</h4> 1628 <dl> 1629 <div style="display: none; "> 1630 <div> 1631 </div> 1632 </div> 1633 </dl> 1634 1635 <!-- CALLBACK --> 1636 <div> 1637 <div> 1638 <h4>Callback function</h4> 1639 <p> 1640 The callback <em>parameter</em> should specify a function 1641 that looks like this: 1642 </p> 1643 <p style="display: none; "> 1644 If you specify the <em>callback</em> parameter, it should 1645 specify a function that looks like this: 1646 </p> 1647 1648 <!-- Note: intentionally longer 80 columns --> 1649 <pre>function(<span>array of Window windows</span>) <span class="subdued">{...}</span>;</pre> 1650 <dl> 1651 <div> 1652 <div> 1653 <dt> 1654 <var>windows</var> 1655 <em> 1656 1657 <!-- TYPE --> 1658 <div style="display:inline"> 1659 ( 1660 <span class="optional" style="display: none; ">optional</span> 1661 <span class="enum" style="display: none; ">enumerated</span> 1662 <span id="typeTemplate"> 1663 <span style="display: none; "> 1664 <a> Type</a> 1665 </span> 1666 <span> 1667 <span> 1668 array of <span><span> 1669 <span> 1670 <a href="windows.html#type-Window">Window</a> 1671 </span> 1672 <span style="display: none; "> 1673 <span> 1674 array of <span><span></span></span> 1675 </span> 1676 <span>paramType</span> 1677 <span></span> 1678 </span> 1679 </span></span> 1680 </span> 1681 <span style="display: none; ">paramType</span> 1682 <span style="display: none; "></span> 1683 </span> 1684 </span> 1685 ) 1686 </div> 1687 1688 </em> 1689 </dt> 1690 <dd class="todo"> 1691 Undocumented. 1692 </dd> 1693 <dd style="display: none; "> 1694 Description of this parameter from the json schema. 1695 </dd> 1696 <dd style="display: none; "> 1697 This parameter was added in version 1698 <b><span></span></b>. 1699 You must omit this parameter in earlier versions, 1700 and you may omit it in any version. If you require this 1701 parameter, the manifest key 1702 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1703 can ensure that your extension won't be run in an earlier browser version. 1704 </dd> 1705 1706 <!-- OBJECT PROPERTIES --> 1707 <dd style="display: none; "> 1708 <dl> 1709 <div> 1710 <div> 1711 </div> 1712 </div> 1713 </dl> 1714 </dd> 1715 1716 <!-- FUNCTION PARAMETERS --> 1717 <dd style="display: none; "> 1718 <div></div> 1719 </dd> 1720 1721 </div> 1722 </div> 1723 </dl> 1724 </div> 1725 </div> 1726 1727 <!-- MIN_VERSION --> 1728 <p style="display: none; "> 1729 This function was added in version <b><span></span></b>. 1730 If you require this function, the manifest key 1731 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1732 can ensure that your extension won't be run in an earlier browser version. 1733 </p> 1734 </div> <!-- /description --> 1735 1736 </div><div class="apiItem"> 1737 <a name="method-getCurrent"></a> <!-- method-anchor --> 1738 <h4>getCurrent</h4> 1739 1740 <div class="summary"><span style="display: none; ">void</span> 1741 <!-- Note: intentionally longer 80 columns --> 1742 <span>chrome.windows.getCurrent</span>(<span class="null"><span style="display: none; ">, </span><span>function</span> 1743 <var><span>callback</span></var></span>)</div> 1744 1745 <div class="description"> 1746 <p class="todo" style="display: none; ">Undocumented.</p> 1747 <p>Gets the <a href="#current-window">current window</a>.</p> 1748 1749 <!-- PARAMETERS --> 1750 <h4>Parameters</h4> 1751 <dl> 1752 <div> 1753 <div> 1754 <dt> 1755 <var>callback</var> 1756 <em> 1757 1758 <!-- TYPE --> 1759 <div style="display:inline"> 1760 ( 1761 <span class="optional" style="display: none; ">optional</span> 1762 <span class="enum" style="display: none; ">enumerated</span> 1763 <span id="typeTemplate"> 1764 <span style="display: none; "> 1765 <a> Type</a> 1766 </span> 1767 <span> 1768 <span style="display: none; "> 1769 array of <span><span></span></span> 1770 </span> 1771 <span>function</span> 1772 <span style="display: none; "></span> 1773 </span> 1774 </span> 1775 ) 1776 </div> 1777 1778 </em> 1779 </dt> 1780 <dd class="todo"> 1781 Undocumented. 1782 </dd> 1783 <dd style="display: none; "> 1784 Description of this parameter from the json schema. 1785 </dd> 1786 <dd style="display: none; "> 1787 This parameter was added in version 1788 <b><span></span></b>. 1789 You must omit this parameter in earlier versions, 1790 and you may omit it in any version. If you require this 1791 parameter, the manifest key 1792 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1793 can ensure that your extension won't be run in an earlier browser version. 1794 </dd> 1795 1796 <!-- OBJECT PROPERTIES --> 1797 <dd style="display: none; "> 1798 <dl> 1799 <div> 1800 <div> 1801 </div> 1802 </div> 1803 </dl> 1804 </dd> 1805 1806 <!-- FUNCTION PARAMETERS --> 1807 <dd style="display: none; "> 1808 <div></div> 1809 </dd> 1810 1811 </div> 1812 </div> 1813 </dl> 1814 1815 <!-- RETURNS --> 1816 <h4 style="display: none; ">Returns</h4> 1817 <dl> 1818 <div style="display: none; "> 1819 <div> 1820 </div> 1821 </div> 1822 </dl> 1823 1824 <!-- CALLBACK --> 1825 <div> 1826 <div> 1827 <h4>Callback function</h4> 1828 <p> 1829 The callback <em>parameter</em> should specify a function 1830 that looks like this: 1831 </p> 1832 <p style="display: none; "> 1833 If you specify the <em>callback</em> parameter, it should 1834 specify a function that looks like this: 1835 </p> 1836 1837 <!-- Note: intentionally longer 80 columns --> 1838 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 1839 <dl> 1840 <div> 1841 <div> 1842 <dt> 1843 <var>window</var> 1844 <em> 1845 1846 <!-- TYPE --> 1847 <div style="display:inline"> 1848 ( 1849 <span class="optional" style="display: none; ">optional</span> 1850 <span class="enum" style="display: none; ">enumerated</span> 1851 <span id="typeTemplate"> 1852 <span> 1853 <a href="windows.html#type-Window">Window</a> 1854 </span> 1855 <span style="display: none; "> 1856 <span> 1857 array of <span><span></span></span> 1858 </span> 1859 <span>paramType</span> 1860 <span></span> 1861 </span> 1862 </span> 1863 ) 1864 </div> 1865 1866 </em> 1867 </dt> 1868 <dd class="todo"> 1869 Undocumented. 1870 </dd> 1871 <dd style="display: none; "> 1872 Description of this parameter from the json schema. 1873 </dd> 1874 <dd style="display: none; "> 1875 This parameter was added in version 1876 <b><span></span></b>. 1877 You must omit this parameter in earlier versions, 1878 and you may omit it in any version. If you require this 1879 parameter, the manifest key 1880 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1881 can ensure that your extension won't be run in an earlier browser version. 1882 </dd> 1883 1884 <!-- OBJECT PROPERTIES --> 1885 <dd style="display: none; "> 1886 <dl> 1887 <div> 1888 <div> 1889 </div> 1890 </div> 1891 </dl> 1892 </dd> 1893 1894 <!-- FUNCTION PARAMETERS --> 1895 <dd style="display: none; "> 1896 <div></div> 1897 </dd> 1898 1899 </div> 1900 </div> 1901 </dl> 1902 </div> 1903 </div> 1904 1905 <!-- MIN_VERSION --> 1906 <p style="display: none; "> 1907 This function was added in version <b><span></span></b>. 1908 If you require this function, the manifest key 1909 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1910 can ensure that your extension won't be run in an earlier browser version. 1911 </p> 1912 </div> <!-- /description --> 1913 1914 </div><div class="apiItem"> 1915 <a name="method-getLastFocused"></a> <!-- method-anchor --> 1916 <h4>getLastFocused</h4> 1917 1918 <div class="summary"><span style="display: none; ">void</span> 1919 <!-- Note: intentionally longer 80 columns --> 1920 <span>chrome.windows.getLastFocused</span>(<span class="null"><span style="display: none; ">, </span><span>function</span> 1921 <var><span>callback</span></var></span>)</div> 1922 1923 <div class="description"> 1924 <p class="todo" style="display: none; ">Undocumented.</p> 1925 <p>Gets the window that was most recently focused — typically the window 'on top'.</p> 1926 1927 <!-- PARAMETERS --> 1928 <h4>Parameters</h4> 1929 <dl> 1930 <div> 1931 <div> 1932 <dt> 1933 <var>callback</var> 1934 <em> 1935 1936 <!-- TYPE --> 1937 <div style="display:inline"> 1938 ( 1939 <span class="optional" style="display: none; ">optional</span> 1940 <span class="enum" style="display: none; ">enumerated</span> 1941 <span id="typeTemplate"> 1942 <span style="display: none; "> 1943 <a> Type</a> 1944 </span> 1945 <span> 1946 <span style="display: none; "> 1947 array of <span><span></span></span> 1948 </span> 1949 <span>function</span> 1950 <span style="display: none; "></span> 1951 </span> 1952 </span> 1953 ) 1954 </div> 1955 1956 </em> 1957 </dt> 1958 <dd class="todo"> 1959 Undocumented. 1960 </dd> 1961 <dd style="display: none; "> 1962 Description of this parameter from the json schema. 1963 </dd> 1964 <dd style="display: none; "> 1965 This parameter was added in version 1966 <b><span></span></b>. 1967 You must omit this parameter in earlier versions, 1968 and you may omit it in any version. If you require this 1969 parameter, the manifest key 1970 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1971 can ensure that your extension won't be run in an earlier browser version. 1972 </dd> 1973 1974 <!-- OBJECT PROPERTIES --> 1975 <dd style="display: none; "> 1976 <dl> 1977 <div> 1978 <div> 1979 </div> 1980 </div> 1981 </dl> 1982 </dd> 1983 1984 <!-- FUNCTION PARAMETERS --> 1985 <dd style="display: none; "> 1986 <div></div> 1987 </dd> 1988 1989 </div> 1990 </div> 1991 </dl> 1992 1993 <!-- RETURNS --> 1994 <h4 style="display: none; ">Returns</h4> 1995 <dl> 1996 <div style="display: none; "> 1997 <div> 1998 </div> 1999 </div> 2000 </dl> 2001 2002 <!-- CALLBACK --> 2003 <div> 2004 <div> 2005 <h4>Callback function</h4> 2006 <p> 2007 The callback <em>parameter</em> should specify a function 2008 that looks like this: 2009 </p> 2010 <p style="display: none; "> 2011 If you specify the <em>callback</em> parameter, it should 2012 specify a function that looks like this: 2013 </p> 2014 2015 <!-- Note: intentionally longer 80 columns --> 2016 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 2017 <dl> 2018 <div> 2019 <div> 2020 <dt> 2021 <var>window</var> 2022 <em> 2023 2024 <!-- TYPE --> 2025 <div style="display:inline"> 2026 ( 2027 <span class="optional" style="display: none; ">optional</span> 2028 <span class="enum" style="display: none; ">enumerated</span> 2029 <span id="typeTemplate"> 2030 <span> 2031 <a href="windows.html#type-Window">Window</a> 2032 </span> 2033 <span style="display: none; "> 2034 <span> 2035 array of <span><span></span></span> 2036 </span> 2037 <span>paramType</span> 2038 <span></span> 2039 </span> 2040 </span> 2041 ) 2042 </div> 2043 2044 </em> 2045 </dt> 2046 <dd class="todo"> 2047 Undocumented. 2048 </dd> 2049 <dd style="display: none; "> 2050 Description of this parameter from the json schema. 2051 </dd> 2052 <dd style="display: none; "> 2053 This parameter was added in version 2054 <b><span></span></b>. 2055 You must omit this parameter in earlier versions, 2056 and you may omit it in any version. If you require this 2057 parameter, the manifest key 2058 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2059 can ensure that your extension won't be run in an earlier browser version. 2060 </dd> 2061 2062 <!-- OBJECT PROPERTIES --> 2063 <dd style="display: none; "> 2064 <dl> 2065 <div> 2066 <div> 2067 </div> 2068 </div> 2069 </dl> 2070 </dd> 2071 2072 <!-- FUNCTION PARAMETERS --> 2073 <dd style="display: none; "> 2074 <div></div> 2075 </dd> 2076 2077 </div> 2078 </div> 2079 </dl> 2080 </div> 2081 </div> 2082 2083 <!-- MIN_VERSION --> 2084 <p style="display: none; "> 2085 This function was added in version <b><span></span></b>. 2086 If you require this function, the manifest key 2087 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2088 can ensure that your extension won't be run in an earlier browser version. 2089 </p> 2090 </div> <!-- /description --> 2091 2092 </div><div class="apiItem"> 2093 <a name="method-remove"></a> <!-- method-anchor --> 2094 <h4>remove</h4> 2095 2096 <div class="summary"><span style="display: none; ">void</span> 2097 <!-- Note: intentionally longer 80 columns --> 2098 <span>chrome.windows.remove</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 2099 <var><span>windowId</span></var></span><span class="optional"><span>, </span><span>function</span> 2100 <var><span>callback</span></var></span>)</div> 2101 2102 <div class="description"> 2103 <p class="todo" style="display: none; ">Undocumented.</p> 2104 <p>Removes (closes) a window, and all the tabs inside it.</p> 2105 2106 <!-- PARAMETERS --> 2107 <h4>Parameters</h4> 2108 <dl> 2109 <div> 2110 <div> 2111 <dt> 2112 <var>windowId</var> 2113 <em> 2114 2115 <!-- TYPE --> 2116 <div style="display:inline"> 2117 ( 2118 <span class="optional" style="display: none; ">optional</span> 2119 <span class="enum" style="display: none; ">enumerated</span> 2120 <span id="typeTemplate"> 2121 <span style="display: none; "> 2122 <a> Type</a> 2123 </span> 2124 <span> 2125 <span style="display: none; "> 2126 array of <span><span></span></span> 2127 </span> 2128 <span>integer</span> 2129 <span style="display: none; "></span> 2130 </span> 2131 </span> 2132 ) 2133 </div> 2134 2135 </em> 2136 </dt> 2137 <dd class="todo"> 2138 Undocumented. 2139 </dd> 2140 <dd style="display: none; "> 2141 Description of this parameter from the json schema. 2142 </dd> 2143 <dd style="display: none; "> 2144 This parameter was added in version 2145 <b><span></span></b>. 2146 You must omit this parameter in earlier versions, 2147 and you may omit it in any version. If you require this 2148 parameter, the manifest key 2149 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2150 can ensure that your extension won't be run in an earlier browser version. 2151 </dd> 2152 2153 <!-- OBJECT PROPERTIES --> 2154 <dd style="display: none; "> 2155 <dl> 2156 <div> 2157 <div> 2158 </div> 2159 </div> 2160 </dl> 2161 </dd> 2162 2163 <!-- FUNCTION PARAMETERS --> 2164 <dd style="display: none; "> 2165 <div></div> 2166 </dd> 2167 2168 </div> 2169 </div><div> 2170 <div> 2171 <dt> 2172 <var>callback</var> 2173 <em> 2174 2175 <!-- TYPE --> 2176 <div style="display:inline"> 2177 ( 2178 <span class="optional">optional</span> 2179 <span class="enum" style="display: none; ">enumerated</span> 2180 <span id="typeTemplate"> 2181 <span style="display: none; "> 2182 <a> Type</a> 2183 </span> 2184 <span> 2185 <span style="display: none; "> 2186 array of <span><span></span></span> 2187 </span> 2188 <span>function</span> 2189 <span style="display: none; "></span> 2190 </span> 2191 </span> 2192 ) 2193 </div> 2194 2195 </em> 2196 </dt> 2197 <dd class="todo"> 2198 Undocumented. 2199 </dd> 2200 <dd style="display: none; "> 2201 Description of this parameter from the json schema. 2202 </dd> 2203 <dd style="display: none; "> 2204 This parameter was added in version 2205 <b><span></span></b>. 2206 You must omit this parameter in earlier versions, 2207 and you may omit it in any version. If you require this 2208 parameter, the manifest key 2209 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2210 can ensure that your extension won't be run in an earlier browser version. 2211 </dd> 2212 2213 <!-- OBJECT PROPERTIES --> 2214 <dd style="display: none; "> 2215 <dl> 2216 <div> 2217 <div> 2218 </div> 2219 </div> 2220 </dl> 2221 </dd> 2222 2223 <!-- FUNCTION PARAMETERS --> 2224 <dd style="display: none; "> 2225 <div></div> 2226 </dd> 2227 2228 </div> 2229 </div> 2230 </dl> 2231 2232 <!-- RETURNS --> 2233 <h4 style="display: none; ">Returns</h4> 2234 <dl> 2235 <div style="display: none; "> 2236 <div> 2237 </div> 2238 </div> 2239 </dl> 2240 2241 <!-- CALLBACK --> 2242 <div> 2243 <div> 2244 <h4>Callback function</h4> 2245 <p style="display: none; "> 2246 The callback <em>parameter</em> should specify a function 2247 that looks like this: 2248 </p> 2249 <p> 2250 If you specify the <em>callback</em> parameter, it should 2251 specify a function that looks like this: 2252 </p> 2253 2254 <!-- Note: intentionally longer 80 columns --> 2255 <pre>function(<span></span>) <span class="subdued">{...}</span>;</pre> 2256 <dl> 2257 <div style="display: none; "> 2258 <div> 2259 </div> 2260 </div> 2261 </dl> 2262 </div> 2263 </div> 2264 2265 <!-- MIN_VERSION --> 2266 <p style="display: none; "> 2267 This function was added in version <b><span></span></b>. 2268 If you require this function, the manifest key 2269 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2270 can ensure that your extension won't be run in an earlier browser version. 2271 </p> 2272 </div> <!-- /description --> 2273 2274 </div><div class="apiItem"> 2275 <a name="method-update"></a> <!-- method-anchor --> 2276 <h4>update</h4> 2277 2278 <div class="summary"><span style="display: none; ">void</span> 2279 <!-- Note: intentionally longer 80 columns --> 2280 <span>chrome.windows.update</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 2281 <var><span>windowId</span></var></span><span class="null"><span>, </span><span>object</span> 2282 <var><span>updateInfo</span></var></span><span class="optional"><span>, </span><span>function</span> 2283 <var><span>callback</span></var></span>)</div> 2284 2285 <div class="description"> 2286 <p class="todo" style="display: none; ">Undocumented.</p> 2287 <p>Updates the properties of a window. Specify only the properties that you want to change; unspecified properties will be left unchanged.</p> 2288 2289 <!-- PARAMETERS --> 2290 <h4>Parameters</h4> 2291 <dl> 2292 <div> 2293 <div> 2294 <dt> 2295 <var>windowId</var> 2296 <em> 2297 2298 <!-- TYPE --> 2299 <div style="display:inline"> 2300 ( 2301 <span class="optional" style="display: none; ">optional</span> 2302 <span class="enum" style="display: none; ">enumerated</span> 2303 <span id="typeTemplate"> 2304 <span style="display: none; "> 2305 <a> Type</a> 2306 </span> 2307 <span> 2308 <span style="display: none; "> 2309 array of <span><span></span></span> 2310 </span> 2311 <span>integer</span> 2312 <span style="display: none; "></span> 2313 </span> 2314 </span> 2315 ) 2316 </div> 2317 2318 </em> 2319 </dt> 2320 <dd class="todo"> 2321 Undocumented. 2322 </dd> 2323 <dd style="display: none; "> 2324 Description of this parameter from the json schema. 2325 </dd> 2326 <dd style="display: none; "> 2327 This parameter was added in version 2328 <b><span></span></b>. 2329 You must omit this parameter in earlier versions, 2330 and you may omit it in any version. If you require this 2331 parameter, the manifest key 2332 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2333 can ensure that your extension won't be run in an earlier browser version. 2334 </dd> 2335 2336 <!-- OBJECT PROPERTIES --> 2337 <dd style="display: none; "> 2338 <dl> 2339 <div> 2340 <div> 2341 </div> 2342 </div> 2343 </dl> 2344 </dd> 2345 2346 <!-- FUNCTION PARAMETERS --> 2347 <dd style="display: none; "> 2348 <div></div> 2349 </dd> 2350 2351 </div> 2352 </div><div> 2353 <div> 2354 <dt> 2355 <var>updateInfo</var> 2356 <em> 2357 2358 <!-- TYPE --> 2359 <div style="display:inline"> 2360 ( 2361 <span class="optional" style="display: none; ">optional</span> 2362 <span class="enum" style="display: none; ">enumerated</span> 2363 <span id="typeTemplate"> 2364 <span style="display: none; "> 2365 <a> Type</a> 2366 </span> 2367 <span> 2368 <span style="display: none; "> 2369 array of <span><span></span></span> 2370 </span> 2371 <span>object</span> 2372 <span style="display: none; "></span> 2373 </span> 2374 </span> 2375 ) 2376 </div> 2377 2378 </em> 2379 </dt> 2380 <dd class="todo"> 2381 Undocumented. 2382 </dd> 2383 <dd style="display: none; "> 2384 Description of this parameter from the json schema. 2385 </dd> 2386 <dd style="display: none; "> 2387 This parameter was added in version 2388 <b><span></span></b>. 2389 You must omit this parameter in earlier versions, 2390 and you may omit it in any version. If you require this 2391 parameter, the manifest key 2392 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2393 can ensure that your extension won't be run in an earlier browser version. 2394 </dd> 2395 2396 <!-- OBJECT PROPERTIES --> 2397 <dd> 2398 <dl> 2399 <div> 2400 <div> 2401 <dt> 2402 <var>left</var> 2403 <em> 2404 2405 <!-- TYPE --> 2406 <div style="display:inline"> 2407 ( 2408 <span class="optional">optional</span> 2409 <span class="enum" style="display: none; ">enumerated</span> 2410 <span id="typeTemplate"> 2411 <span style="display: none; "> 2412 <a> Type</a> 2413 </span> 2414 <span> 2415 <span style="display: none; "> 2416 array of <span><span></span></span> 2417 </span> 2418 <span>integer</span> 2419 <span style="display: none; "></span> 2420 </span> 2421 </span> 2422 ) 2423 </div> 2424 2425 </em> 2426 </dt> 2427 <dd class="todo" style="display: none; "> 2428 Undocumented. 2429 </dd> 2430 <dd>The offset from the left edge of the screen to move the window to in pixels.</dd> 2431 <dd style="display: none; "> 2432 This parameter was added in version 2433 <b><span></span></b>. 2434 You must omit this parameter in earlier versions, 2435 and you may omit it in any version. If you require this 2436 parameter, the manifest key 2437 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2438 can ensure that your extension won't be run in an earlier browser version. 2439 </dd> 2440 2441 <!-- OBJECT PROPERTIES --> 2442 <dd style="display: none; "> 2443 <dl> 2444 <div> 2445 <div> 2446 </div> 2447 </div> 2448 </dl> 2449 </dd> 2450 2451 <!-- FUNCTION PARAMETERS --> 2452 <dd style="display: none; "> 2453 <div></div> 2454 </dd> 2455 2456 </div> 2457 </div><div> 2458 <div> 2459 <dt> 2460 <var>top</var> 2461 <em> 2462 2463 <!-- TYPE --> 2464 <div style="display:inline"> 2465 ( 2466 <span class="optional">optional</span> 2467 <span class="enum" style="display: none; ">enumerated</span> 2468 <span id="typeTemplate"> 2469 <span style="display: none; "> 2470 <a> Type</a> 2471 </span> 2472 <span> 2473 <span style="display: none; "> 2474 array of <span><span></span></span> 2475 </span> 2476 <span>integer</span> 2477 <span style="display: none; "></span> 2478 </span> 2479 </span> 2480 ) 2481 </div> 2482 2483 </em> 2484 </dt> 2485 <dd class="todo" style="display: none; "> 2486 Undocumented. 2487 </dd> 2488 <dd>The offset from the top edge of the screen to move the window to in pixels.</dd> 2489 <dd style="display: none; "> 2490 This parameter was added in version 2491 <b><span></span></b>. 2492 You must omit this parameter in earlier versions, 2493 and you may omit it in any version. If you require this 2494 parameter, the manifest key 2495 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2496 can ensure that your extension won't be run in an earlier browser version. 2497 </dd> 2498 2499 <!-- OBJECT PROPERTIES --> 2500 <dd style="display: none; "> 2501 <dl> 2502 <div> 2503 <div> 2504 </div> 2505 </div> 2506 </dl> 2507 </dd> 2508 2509 <!-- FUNCTION PARAMETERS --> 2510 <dd style="display: none; "> 2511 <div></div> 2512 </dd> 2513 2514 </div> 2515 </div><div> 2516 <div> 2517 <dt> 2518 <var>width</var> 2519 <em> 2520 2521 <!-- TYPE --> 2522 <div style="display:inline"> 2523 ( 2524 <span class="optional">optional</span> 2525 <span class="enum" style="display: none; ">enumerated</span> 2526 <span id="typeTemplate"> 2527 <span style="display: none; "> 2528 <a> Type</a> 2529 </span> 2530 <span> 2531 <span style="display: none; "> 2532 array of <span><span></span></span> 2533 </span> 2534 <span>integer</span> 2535 <span style="display: none; "></span> 2536 </span> 2537 </span> 2538 ) 2539 </div> 2540 2541 </em> 2542 </dt> 2543 <dd class="todo" style="display: none; "> 2544 Undocumented. 2545 </dd> 2546 <dd>The width to resize the window to in pixels.</dd> 2547 <dd style="display: none; "> 2548 This parameter was added in version 2549 <b><span></span></b>. 2550 You must omit this parameter in earlier versions, 2551 and you may omit it in any version. If you require this 2552 parameter, the manifest key 2553 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2554 can ensure that your extension won't be run in an earlier browser version. 2555 </dd> 2556 2557 <!-- OBJECT PROPERTIES --> 2558 <dd style="display: none; "> 2559 <dl> 2560 <div> 2561 <div> 2562 </div> 2563 </div> 2564 </dl> 2565 </dd> 2566 2567 <!-- FUNCTION PARAMETERS --> 2568 <dd style="display: none; "> 2569 <div></div> 2570 </dd> 2571 2572 </div> 2573 </div><div> 2574 <div> 2575 <dt> 2576 <var>height</var> 2577 <em> 2578 2579 <!-- TYPE --> 2580 <div style="display:inline"> 2581 ( 2582 <span class="optional">optional</span> 2583 <span class="enum" style="display: none; ">enumerated</span> 2584 <span id="typeTemplate"> 2585 <span style="display: none; "> 2586 <a> Type</a> 2587 </span> 2588 <span> 2589 <span style="display: none; "> 2590 array of <span><span></span></span> 2591 </span> 2592 <span>integer</span> 2593 <span style="display: none; "></span> 2594 </span> 2595 </span> 2596 ) 2597 </div> 2598 2599 </em> 2600 </dt> 2601 <dd class="todo" style="display: none; "> 2602 Undocumented. 2603 </dd> 2604 <dd>The height to resize the window to in pixels.</dd> 2605 <dd style="display: none; "> 2606 This parameter was added in version 2607 <b><span></span></b>. 2608 You must omit this parameter in earlier versions, 2609 and you may omit it in any version. If you require this 2610 parameter, the manifest key 2611 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2612 can ensure that your extension won't be run in an earlier browser version. 2613 </dd> 2614 2615 <!-- OBJECT PROPERTIES --> 2616 <dd style="display: none; "> 2617 <dl> 2618 <div> 2619 <div> 2620 </div> 2621 </div> 2622 </dl> 2623 </dd> 2624 2625 <!-- FUNCTION PARAMETERS --> 2626 <dd style="display: none; "> 2627 <div></div> 2628 </dd> 2629 2630 </div> 2631 </div><div> 2632 <div> 2633 <dt> 2634 <var>focused</var> 2635 <em> 2636 2637 <!-- TYPE --> 2638 <div style="display:inline"> 2639 ( 2640 <span class="optional">optional</span> 2641 <span class="enum" style="display: none; ">enumerated</span> 2642 <span id="typeTemplate"> 2643 <span style="display: none; "> 2644 <a> Type</a> 2645 </span> 2646 <span> 2647 <span style="display: none; "> 2648 array of <span><span></span></span> 2649 </span> 2650 <span>boolean</span> 2651 <span style="display: none; "></span> 2652 </span> 2653 </span> 2654 ) 2655 </div> 2656 2657 </em> 2658 </dt> 2659 <dd class="todo" style="display: none; "> 2660 Undocumented. 2661 </dd> 2662 <dd>It true, brings the window to the front. If false, brings the next window in the z-order to the front.</dd> 2663 <dd style="display: none; "> 2664 This parameter was added in version 2665 <b><span></span></b>. 2666 You must omit this parameter in earlier versions, 2667 and you may omit it in any version. If you require this 2668 parameter, the manifest key 2669 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2670 can ensure that your extension won't be run in an earlier browser version. 2671 </dd> 2672 2673 <!-- OBJECT PROPERTIES --> 2674 <dd style="display: none; "> 2675 <dl> 2676 <div> 2677 <div> 2678 </div> 2679 </div> 2680 </dl> 2681 </dd> 2682 2683 <!-- FUNCTION PARAMETERS --> 2684 <dd style="display: none; "> 2685 <div></div> 2686 </dd> 2687 2688 </div> 2689 </div> 2690 </dl> 2691 </dd> 2692 2693 <!-- FUNCTION PARAMETERS --> 2694 <dd style="display: none; "> 2695 <div></div> 2696 </dd> 2697 2698 </div> 2699 </div><div> 2700 <div> 2701 <dt> 2702 <var>callback</var> 2703 <em> 2704 2705 <!-- TYPE --> 2706 <div style="display:inline"> 2707 ( 2708 <span class="optional">optional</span> 2709 <span class="enum" style="display: none; ">enumerated</span> 2710 <span id="typeTemplate"> 2711 <span style="display: none; "> 2712 <a> Type</a> 2713 </span> 2714 <span> 2715 <span style="display: none; "> 2716 array of <span><span></span></span> 2717 </span> 2718 <span>function</span> 2719 <span style="display: none; "></span> 2720 </span> 2721 </span> 2722 ) 2723 </div> 2724 2725 </em> 2726 </dt> 2727 <dd class="todo"> 2728 Undocumented. 2729 </dd> 2730 <dd style="display: none; "> 2731 Description of this parameter from the json schema. 2732 </dd> 2733 <dd style="display: none; "> 2734 This parameter was added in version 2735 <b><span></span></b>. 2736 You must omit this parameter in earlier versions, 2737 and you may omit it in any version. If you require this 2738 parameter, the manifest key 2739 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2740 can ensure that your extension won't be run in an earlier browser version. 2741 </dd> 2742 2743 <!-- OBJECT PROPERTIES --> 2744 <dd style="display: none; "> 2745 <dl> 2746 <div> 2747 <div> 2748 </div> 2749 </div> 2750 </dl> 2751 </dd> 2752 2753 <!-- FUNCTION PARAMETERS --> 2754 <dd style="display: none; "> 2755 <div></div> 2756 </dd> 2757 2758 </div> 2759 </div> 2760 </dl> 2761 2762 <!-- RETURNS --> 2763 <h4 style="display: none; ">Returns</h4> 2764 <dl> 2765 <div style="display: none; "> 2766 <div> 2767 </div> 2768 </div> 2769 </dl> 2770 2771 <!-- CALLBACK --> 2772 <div> 2773 <div> 2774 <h4>Callback function</h4> 2775 <p style="display: none; "> 2776 The callback <em>parameter</em> should specify a function 2777 that looks like this: 2778 </p> 2779 <p> 2780 If you specify the <em>callback</em> parameter, it should 2781 specify a function that looks like this: 2782 </p> 2783 2784 <!-- Note: intentionally longer 80 columns --> 2785 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 2786 <dl> 2787 <div> 2788 <div> 2789 <dt> 2790 <var>window</var> 2791 <em> 2792 2793 <!-- TYPE --> 2794 <div style="display:inline"> 2795 ( 2796 <span class="optional" style="display: none; ">optional</span> 2797 <span class="enum" style="display: none; ">enumerated</span> 2798 <span id="typeTemplate"> 2799 <span> 2800 <a href="windows.html#type-Window">Window</a> 2801 </span> 2802 <span style="display: none; "> 2803 <span> 2804 array of <span><span></span></span> 2805 </span> 2806 <span>paramType</span> 2807 <span></span> 2808 </span> 2809 </span> 2810 ) 2811 </div> 2812 2813 </em> 2814 </dt> 2815 <dd class="todo"> 2816 Undocumented. 2817 </dd> 2818 <dd style="display: none; "> 2819 Description of this parameter from the json schema. 2820 </dd> 2821 <dd style="display: none; "> 2822 This parameter was added in version 2823 <b><span></span></b>. 2824 You must omit this parameter in earlier versions, 2825 and you may omit it in any version. If you require this 2826 parameter, the manifest key 2827 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2828 can ensure that your extension won't be run in an earlier browser version. 2829 </dd> 2830 2831 <!-- OBJECT PROPERTIES --> 2832 <dd style="display: none; "> 2833 <dl> 2834 <div> 2835 <div> 2836 </div> 2837 </div> 2838 </dl> 2839 </dd> 2840 2841 <!-- FUNCTION PARAMETERS --> 2842 <dd style="display: none; "> 2843 <div></div> 2844 </dd> 2845 2846 </div> 2847 </div> 2848 </dl> 2849 </div> 2850 </div> 2851 2852 <!-- MIN_VERSION --> 2853 <p style="display: none; "> 2854 This function was added in version <b><span></span></b>. 2855 If you require this function, the manifest key 2856 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2857 can ensure that your extension won't be run in an earlier browser version. 2858 </p> 2859 </div> <!-- /description --> 2860 2861 </div> <!-- /apiItem --> 2862 2863 </div> <!-- /apiGroup --> 2864 2865 <!-- EVENTS --> 2866 <div class="apiGroup"> 2867 <a name="events"></a> 2868 <h3 id="events">Events</h3> 2869 2870 <!-- iterates over all events --> 2871 <div class="apiItem"> 2872 <a name="event-onCreated"></a> 2873 <h4>onCreated</h4> 2874 2875 <div class="summary"> 2876 <!-- Note: intentionally longer 80 columns --> 2877 <span class="subdued">chrome.windows.</span><span>onCreated</span><span class="subdued">.addListener</span>(function(<span>Window window</span>) <span class="subdued">{...}</span>); 2878 </div> 2879 2880 <div class="description"> 2881 <p class="todo" style="display: none; ">Undocumented.</p> 2882 <p>Fired when a window is created.</p> 2883 2884 <!-- PARAMETERS --> 2885 <h4>Parameters</h4> 2886 <dl> 2887 <div> 2888 <div> 2889 <dt> 2890 <var>window</var> 2891 <em> 2892 2893 <!-- TYPE --> 2894 <div style="display:inline"> 2895 ( 2896 <span class="optional" style="display: none; ">optional</span> 2897 <span class="enum" style="display: none; ">enumerated</span> 2898 <span id="typeTemplate"> 2899 <span> 2900 <a href="windows.html#type-Window">Window</a> 2901 </span> 2902 <span style="display: none; "> 2903 <span> 2904 array of <span><span></span></span> 2905 </span> 2906 <span>paramType</span> 2907 <span></span> 2908 </span> 2909 </span> 2910 ) 2911 </div> 2912 2913 </em> 2914 </dt> 2915 <dd class="todo" style="display: none; "> 2916 Undocumented. 2917 </dd> 2918 <dd>Details of the window that was created.</dd> 2919 <dd style="display: none; "> 2920 This parameter was added in version 2921 <b><span></span></b>. 2922 You must omit this parameter in earlier versions, 2923 and you may omit it in any version. If you require this 2924 parameter, the manifest key 2925 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2926 can ensure that your extension won't be run in an earlier browser version. 2927 </dd> 2928 2929 <!-- OBJECT PROPERTIES --> 2930 <dd style="display: none; "> 2931 <dl> 2932 <div> 2933 <div> 2934 </div> 2935 </div> 2936 </dl> 2937 </dd> 2938 2939 <!-- FUNCTION PARAMETERS --> 2940 <dd style="display: none; "> 2941 <div></div> 2942 </dd> 2943 2944 </div> 2945 </div> 2946 </dl> 2947 2948 </div> <!-- /decription --> 2949 2950 </div><div class="apiItem"> 2951 <a name="event-onFocusChanged"></a> 2952 <h4>onFocusChanged</h4> 2953 2954 <div class="summary"> 2955 <!-- Note: intentionally longer 80 columns --> 2956 <span class="subdued">chrome.windows.</span><span>onFocusChanged</span><span class="subdued">.addListener</span>(function(<span>integer windowId</span>) <span class="subdued">{...}</span>); 2957 </div> 2958 2959 <div class="description"> 2960 <p class="todo" style="display: none; ">Undocumented.</p> 2961 <p>Fired when the currently focused window changes. Will be chrome.windows.WINDOW_ID_NONE if all chrome windows have lost focus. Note: On some Linux window managers, WINDOW_ID_NONE will always be sent immediately preceding a switch from one chrome window to another.</p> 2962 2963 <!-- PARAMETERS --> 2964 <h4>Parameters</h4> 2965 <dl> 2966 <div> 2967 <div> 2968 <dt> 2969 <var>windowId</var> 2970 <em> 2971 2972 <!-- TYPE --> 2973 <div style="display:inline"> 2974 ( 2975 <span class="optional" style="display: none; ">optional</span> 2976 <span class="enum" style="display: none; ">enumerated</span> 2977 <span id="typeTemplate"> 2978 <span style="display: none; "> 2979 <a> Type</a> 2980 </span> 2981 <span> 2982 <span style="display: none; "> 2983 array of <span><span></span></span> 2984 </span> 2985 <span>integer</span> 2986 <span style="display: none; "></span> 2987 </span> 2988 </span> 2989 ) 2990 </div> 2991 2992 </em> 2993 </dt> 2994 <dd class="todo" style="display: none; "> 2995 Undocumented. 2996 </dd> 2997 <dd>ID of the newly focused window.</dd> 2998 <dd style="display: none; "> 2999 This parameter was added in version 3000 <b><span></span></b>. 3001 You must omit this parameter in earlier versions, 3002 and you may omit it in any version. If you require this 3003 parameter, the manifest key 3004 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3005 can ensure that your extension won't be run in an earlier browser version. 3006 </dd> 3007 3008 <!-- OBJECT PROPERTIES --> 3009 <dd style="display: none; "> 3010 <dl> 3011 <div> 3012 <div> 3013 </div> 3014 </div> 3015 </dl> 3016 </dd> 3017 3018 <!-- FUNCTION PARAMETERS --> 3019 <dd style="display: none; "> 3020 <div></div> 3021 </dd> 3022 3023 </div> 3024 </div> 3025 </dl> 3026 3027 </div> <!-- /decription --> 3028 3029 </div><div class="apiItem"> 3030 <a name="event-onRemoved"></a> 3031 <h4>onRemoved</h4> 3032 3033 <div class="summary"> 3034 <!-- Note: intentionally longer 80 columns --> 3035 <span class="subdued">chrome.windows.</span><span>onRemoved</span><span class="subdued">.addListener</span>(function(<span>integer windowId</span>) <span class="subdued">{...}</span>); 3036 </div> 3037 3038 <div class="description"> 3039 <p class="todo" style="display: none; ">Undocumented.</p> 3040 <p>Fired when a window is removed (closed).</p> 3041 3042 <!-- PARAMETERS --> 3043 <h4>Parameters</h4> 3044 <dl> 3045 <div> 3046 <div> 3047 <dt> 3048 <var>windowId</var> 3049 <em> 3050 3051 <!-- TYPE --> 3052 <div style="display:inline"> 3053 ( 3054 <span class="optional" style="display: none; ">optional</span> 3055 <span class="enum" style="display: none; ">enumerated</span> 3056 <span id="typeTemplate"> 3057 <span style="display: none; "> 3058 <a> Type</a> 3059 </span> 3060 <span> 3061 <span style="display: none; "> 3062 array of <span><span></span></span> 3063 </span> 3064 <span>integer</span> 3065 <span style="display: none; "></span> 3066 </span> 3067 </span> 3068 ) 3069 </div> 3070 3071 </em> 3072 </dt> 3073 <dd class="todo" style="display: none; "> 3074 Undocumented. 3075 </dd> 3076 <dd>ID of the removed window.</dd> 3077 <dd style="display: none; "> 3078 This parameter was added in version 3079 <b><span></span></b>. 3080 You must omit this parameter in earlier versions, 3081 and you may omit it in any version. If you require this 3082 parameter, the manifest key 3083 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3084 can ensure that your extension won't be run in an earlier browser version. 3085 </dd> 3086 3087 <!-- OBJECT PROPERTIES --> 3088 <dd style="display: none; "> 3089 <dl> 3090 <div> 3091 <div> 3092 </div> 3093 </div> 3094 </dl> 3095 </dd> 3096 3097 <!-- FUNCTION PARAMETERS --> 3098 <dd style="display: none; "> 3099 <div></div> 3100 </dd> 3101 3102 </div> 3103 </div> 3104 </dl> 3105 3106 </div> <!-- /decription --> 3107 3108 </div> <!-- /apiItem --> 3109 3110 </div> <!-- /apiGroup --> 3111 3112 <!-- TYPES --> 3113 <div class="apiGroup"> 3114 <a name="types"></a> 3115 <h3 id="types">Types</h3> 3116 3117 <!-- iterates over all types --> 3118 <div class="apiItem"> 3119 <a name="type-Window"></a> 3120 <h4>Window</h4> 3121 3122 <div> 3123 <dt> 3124 <var style="display: none; ">paramName</var> 3125 <em> 3126 3127 <!-- TYPE --> 3128 <div style="display:inline"> 3129 ( 3130 <span class="optional" style="display: none; ">optional</span> 3131 <span class="enum" style="display: none; ">enumerated</span> 3132 <span id="typeTemplate"> 3133 <span style="display: none; "> 3134 <a> Type</a> 3135 </span> 3136 <span> 3137 <span style="display: none; "> 3138 array of <span><span></span></span> 3139 </span> 3140 <span>object</span> 3141 <span style="display: none; "></span> 3142 </span> 3143 </span> 3144 ) 3145 </div> 3146 3147 </em> 3148 </dt> 3149 <dd class="todo"> 3150 Undocumented. 3151 </dd> 3152 <dd style="display: none; "> 3153 Description of this parameter from the json schema. 3154 </dd> 3155 <dd style="display: none; "> 3156 This parameter was added in version 3157 <b><span></span></b>. 3158 You must omit this parameter in earlier versions, 3159 and you may omit it in any version. If you require this 3160 parameter, the manifest key 3161 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3162 can ensure that your extension won't be run in an earlier browser version. 3163 </dd> 3164 3165 <!-- OBJECT PROPERTIES --> 3166 <dd> 3167 <dl> 3168 <div> 3169 <div> 3170 <dt> 3171 <var>id</var> 3172 <em> 3173 3174 <!-- TYPE --> 3175 <div style="display:inline"> 3176 ( 3177 <span class="optional" style="display: none; ">optional</span> 3178 <span class="enum" style="display: none; ">enumerated</span> 3179 <span id="typeTemplate"> 3180 <span style="display: none; "> 3181 <a> Type</a> 3182 </span> 3183 <span> 3184 <span style="display: none; "> 3185 array of <span><span></span></span> 3186 </span> 3187 <span>integer</span> 3188 <span style="display: none; "></span> 3189 </span> 3190 </span> 3191 ) 3192 </div> 3193 3194 </em> 3195 </dt> 3196 <dd class="todo" style="display: none; "> 3197 Undocumented. 3198 </dd> 3199 <dd>The ID of the window. Window IDs are unique within a browser session.</dd> 3200 <dd style="display: none; "> 3201 This parameter was added in version 3202 <b><span></span></b>. 3203 You must omit this parameter in earlier versions, 3204 and you may omit it in any version. If you require this 3205 parameter, the manifest key 3206 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3207 can ensure that your extension won't be run in an earlier browser version. 3208 </dd> 3209 3210 <!-- OBJECT PROPERTIES --> 3211 <dd style="display: none; "> 3212 <dl> 3213 <div> 3214 <div> 3215 </div> 3216 </div> 3217 </dl> 3218 </dd> 3219 3220 <!-- FUNCTION PARAMETERS --> 3221 <dd style="display: none; "> 3222 <div></div> 3223 </dd> 3224 3225 </div> 3226 </div><div> 3227 <div> 3228 <dt> 3229 <var>focused</var> 3230 <em> 3231 3232 <!-- TYPE --> 3233 <div style="display:inline"> 3234 ( 3235 <span class="optional" style="display: none; ">optional</span> 3236 <span class="enum" style="display: none; ">enumerated</span> 3237 <span id="typeTemplate"> 3238 <span style="display: none; "> 3239 <a> Type</a> 3240 </span> 3241 <span> 3242 <span style="display: none; "> 3243 array of <span><span></span></span> 3244 </span> 3245 <span>boolean</span> 3246 <span style="display: none; "></span> 3247 </span> 3248 </span> 3249 ) 3250 </div> 3251 3252 </em> 3253 </dt> 3254 <dd class="todo" style="display: none; "> 3255 Undocumented. 3256 </dd> 3257 <dd>Whether the window is currently the focused window.</dd> 3258 <dd style="display: none; "> 3259 This parameter was added in version 3260 <b><span></span></b>. 3261 You must omit this parameter in earlier versions, 3262 and you may omit it in any version. If you require this 3263 parameter, the manifest key 3264 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3265 can ensure that your extension won't be run in an earlier browser version. 3266 </dd> 3267 3268 <!-- OBJECT PROPERTIES --> 3269 <dd style="display: none; "> 3270 <dl> 3271 <div> 3272 <div> 3273 </div> 3274 </div> 3275 </dl> 3276 </dd> 3277 3278 <!-- FUNCTION PARAMETERS --> 3279 <dd style="display: none; "> 3280 <div></div> 3281 </dd> 3282 3283 </div> 3284 </div><div> 3285 <div> 3286 <dt> 3287 <var>top</var> 3288 <em> 3289 3290 <!-- TYPE --> 3291 <div style="display:inline"> 3292 ( 3293 <span class="optional" style="display: none; ">optional</span> 3294 <span class="enum" style="display: none; ">enumerated</span> 3295 <span id="typeTemplate"> 3296 <span style="display: none; "> 3297 <a> Type</a> 3298 </span> 3299 <span> 3300 <span style="display: none; "> 3301 array of <span><span></span></span> 3302 </span> 3303 <span>integer</span> 3304 <span style="display: none; "></span> 3305 </span> 3306 </span> 3307 ) 3308 </div> 3309 3310 </em> 3311 </dt> 3312 <dd class="todo" style="display: none; "> 3313 Undocumented. 3314 </dd> 3315 <dd>The offset of the window from the top edge of the screen in pixels.</dd> 3316 <dd style="display: none; "> 3317 This parameter was added in version 3318 <b><span></span></b>. 3319 You must omit this parameter in earlier versions, 3320 and you may omit it in any version. If you require this 3321 parameter, the manifest key 3322 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3323 can ensure that your extension won't be run in an earlier browser version. 3324 </dd> 3325 3326 <!-- OBJECT PROPERTIES --> 3327 <dd style="display: none; "> 3328 <dl> 3329 <div> 3330 <div> 3331 </div> 3332 </div> 3333 </dl> 3334 </dd> 3335 3336 <!-- FUNCTION PARAMETERS --> 3337 <dd style="display: none; "> 3338 <div></div> 3339 </dd> 3340 3341 </div> 3342 </div><div> 3343 <div> 3344 <dt> 3345 <var>left</var> 3346 <em> 3347 3348 <!-- TYPE --> 3349 <div style="display:inline"> 3350 ( 3351 <span class="optional" style="display: none; ">optional</span> 3352 <span class="enum" style="display: none; ">enumerated</span> 3353 <span id="typeTemplate"> 3354 <span style="display: none; "> 3355 <a> Type</a> 3356 </span> 3357 <span> 3358 <span style="display: none; "> 3359 array of <span><span></span></span> 3360 </span> 3361 <span>integer</span> 3362 <span style="display: none; "></span> 3363 </span> 3364 </span> 3365 ) 3366 </div> 3367 3368 </em> 3369 </dt> 3370 <dd class="todo" style="display: none; "> 3371 Undocumented. 3372 </dd> 3373 <dd>The offset of the window from the left edge of the screen in pixels.</dd> 3374 <dd style="display: none; "> 3375 This parameter was added in version 3376 <b><span></span></b>. 3377 You must omit this parameter in earlier versions, 3378 and you may omit it in any version. If you require this 3379 parameter, the manifest key 3380 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3381 can ensure that your extension won't be run in an earlier browser version. 3382 </dd> 3383 3384 <!-- OBJECT PROPERTIES --> 3385 <dd style="display: none; "> 3386 <dl> 3387 <div> 3388 <div> 3389 </div> 3390 </div> 3391 </dl> 3392 </dd> 3393 3394 <!-- FUNCTION PARAMETERS --> 3395 <dd style="display: none; "> 3396 <div></div> 3397 </dd> 3398 3399 </div> 3400 </div><div> 3401 <div> 3402 <dt> 3403 <var>width</var> 3404 <em> 3405 3406 <!-- TYPE --> 3407 <div style="display:inline"> 3408 ( 3409 <span class="optional" style="display: none; ">optional</span> 3410 <span class="enum" style="display: none; ">enumerated</span> 3411 <span id="typeTemplate"> 3412 <span style="display: none; "> 3413 <a> Type</a> 3414 </span> 3415 <span> 3416 <span style="display: none; "> 3417 array of <span><span></span></span> 3418 </span> 3419 <span>integer</span> 3420 <span style="display: none; "></span> 3421 </span> 3422 </span> 3423 ) 3424 </div> 3425 3426 </em> 3427 </dt> 3428 <dd class="todo" style="display: none; "> 3429 Undocumented. 3430 </dd> 3431 <dd>The width of the window in pixels.</dd> 3432 <dd style="display: none; "> 3433 This parameter was added in version 3434 <b><span></span></b>. 3435 You must omit this parameter in earlier versions, 3436 and you may omit it in any version. If you require this 3437 parameter, the manifest key 3438 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3439 can ensure that your extension won't be run in an earlier browser version. 3440 </dd> 3441 3442 <!-- OBJECT PROPERTIES --> 3443 <dd style="display: none; "> 3444 <dl> 3445 <div> 3446 <div> 3447 </div> 3448 </div> 3449 </dl> 3450 </dd> 3451 3452 <!-- FUNCTION PARAMETERS --> 3453 <dd style="display: none; "> 3454 <div></div> 3455 </dd> 3456 3457 </div> 3458 </div><div> 3459 <div> 3460 <dt> 3461 <var>height</var> 3462 <em> 3463 3464 <!-- TYPE --> 3465 <div style="display:inline"> 3466 ( 3467 <span class="optional" style="display: none; ">optional</span> 3468 <span class="enum" style="display: none; ">enumerated</span> 3469 <span id="typeTemplate"> 3470 <span style="display: none; "> 3471 <a> Type</a> 3472 </span> 3473 <span> 3474 <span style="display: none; "> 3475 array of <span><span></span></span> 3476 </span> 3477 <span>integer</span> 3478 <span style="display: none; "></span> 3479 </span> 3480 </span> 3481 ) 3482 </div> 3483 3484 </em> 3485 </dt> 3486 <dd class="todo" style="display: none; "> 3487 Undocumented. 3488 </dd> 3489 <dd>The height of the window in pixels.</dd> 3490 <dd style="display: none; "> 3491 This parameter was added in version 3492 <b><span></span></b>. 3493 You must omit this parameter in earlier versions, 3494 and you may omit it in any version. If you require this 3495 parameter, the manifest key 3496 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3497 can ensure that your extension won't be run in an earlier browser version. 3498 </dd> 3499 3500 <!-- OBJECT PROPERTIES --> 3501 <dd style="display: none; "> 3502 <dl> 3503 <div> 3504 <div> 3505 </div> 3506 </div> 3507 </dl> 3508 </dd> 3509 3510 <!-- FUNCTION PARAMETERS --> 3511 <dd style="display: none; "> 3512 <div></div> 3513 </dd> 3514 3515 </div> 3516 </div><div> 3517 <div> 3518 <dt> 3519 <var>tabs</var> 3520 <em> 3521 3522 <!-- TYPE --> 3523 <div style="display:inline"> 3524 ( 3525 <span class="optional">optional</span> 3526 <span class="enum" style="display: none; ">enumerated</span> 3527 <span id="typeTemplate"> 3528 <span style="display: none; "> 3529 <a> Type</a> 3530 </span> 3531 <span> 3532 <span> 3533 array of <span><span> 3534 <span> 3535 <a href="tabs.html#type-Tab">Tab</a> 3536 </span> 3537 <span style="display: none; "> 3538 <span> 3539 array of <span><span></span></span> 3540 </span> 3541 <span>paramType</span> 3542 <span></span> 3543 </span> 3544 </span></span> 3545 </span> 3546 <span style="display: none; ">paramType</span> 3547 <span style="display: none; "></span> 3548 </span> 3549 </span> 3550 ) 3551 </div> 3552 3553 </em> 3554 </dt> 3555 <dd class="todo" style="display: none; "> 3556 Undocumented. 3557 </dd> 3558 <dd>Array of <a href="tabs.html#type-Tab">Tab</a> objects representing the current tabs in the window.</dd> 3559 <dd style="display: none; "> 3560 This parameter was added in version 3561 <b><span></span></b>. 3562 You must omit this parameter in earlier versions, 3563 and you may omit it in any version. If you require this 3564 parameter, the manifest key 3565 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3566 can ensure that your extension won't be run in an earlier browser version. 3567 </dd> 3568 3569 <!-- OBJECT PROPERTIES --> 3570 <dd style="display: none; "> 3571 <dl> 3572 <div> 3573 <div> 3574 </div> 3575 </div> 3576 </dl> 3577 </dd> 3578 3579 <!-- FUNCTION PARAMETERS --> 3580 <dd style="display: none; "> 3581 <div></div> 3582 </dd> 3583 3584 </div> 3585 </div><div> 3586 <div> 3587 <dt> 3588 <var>incognito</var> 3589 <em> 3590 3591 <!-- TYPE --> 3592 <div style="display:inline"> 3593 ( 3594 <span class="optional" style="display: none; ">optional</span> 3595 <span class="enum" style="display: none; ">enumerated</span> 3596 <span id="typeTemplate"> 3597 <span style="display: none; "> 3598 <a> Type</a> 3599 </span> 3600 <span> 3601 <span style="display: none; "> 3602 array of <span><span></span></span> 3603 </span> 3604 <span>boolean</span> 3605 <span style="display: none; "></span> 3606 </span> 3607 </span> 3608 ) 3609 </div> 3610 3611 </em> 3612 </dt> 3613 <dd class="todo" style="display: none; "> 3614 Undocumented. 3615 </dd> 3616 <dd>Whether the window is incognito.</dd> 3617 <dd style="display: none; "> 3618 This parameter was added in version 3619 <b><span></span></b>. 3620 You must omit this parameter in earlier versions, 3621 and you may omit it in any version. If you require this 3622 parameter, the manifest key 3623 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3624 can ensure that your extension won't be run in an earlier browser version. 3625 </dd> 3626 3627 <!-- OBJECT PROPERTIES --> 3628 <dd style="display: none; "> 3629 <dl> 3630 <div> 3631 <div> 3632 </div> 3633 </div> 3634 </dl> 3635 </dd> 3636 3637 <!-- FUNCTION PARAMETERS --> 3638 <dd style="display: none; "> 3639 <div></div> 3640 </dd> 3641 3642 </div> 3643 </div><div> 3644 <div> 3645 <dt> 3646 <var>type</var> 3647 <em> 3648 3649 <!-- TYPE --> 3650 <div style="display:inline"> 3651 ( 3652 <span class="optional" style="display: none; ">optional</span> 3653 <span class="enum">enumerated</span> 3654 <span id="typeTemplate"> 3655 <span style="display: none; "> 3656 <a> Type</a> 3657 </span> 3658 <span> 3659 <span style="display: none; "> 3660 array of <span><span></span></span> 3661 </span> 3662 <span>string</span> 3663 <span>["normal", "popup", "app"]</span> 3664 </span> 3665 </span> 3666 ) 3667 </div> 3668 3669 </em> 3670 </dt> 3671 <dd class="todo" style="display: none; "> 3672 Undocumented. 3673 </dd> 3674 <dd>The type of browser window this is.</dd> 3675 <dd style="display: none; "> 3676 This parameter was added in version 3677 <b><span></span></b>. 3678 You must omit this parameter in earlier versions, 3679 and you may omit it in any version. If you require this 3680 parameter, the manifest key 3681 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3682 can ensure that your extension won't be run in an earlier browser version. 3683 </dd> 3684 3685 <!-- OBJECT PROPERTIES --> 3686 <dd style="display: none; "> 3687 <dl> 3688 <div> 3689 <div> 3690 </div> 3691 </div> 3692 </dl> 3693 </dd> 3694 3695 <!-- FUNCTION PARAMETERS --> 3696 <dd style="display: none; "> 3697 <div></div> 3698 </dd> 3699 3700 </div> 3701 </div> 3702 </dl> 3703 </dd> 3704 3705 <!-- FUNCTION PARAMETERS --> 3706 <dd style="display: none; "> 3707 <div></div> 3708 </dd> 3709 3710 </div> 3711 3712 </div> <!-- /apiItem --> 3713 3714 </div> <!-- /apiGroup --> 3715 3716 </div> <!-- /apiPage --> 3717 </div> <!-- /gc-pagecontent --> 3718 </div> <!-- /g-section --> 3719 </div> <!-- /codesiteContent --> 3720 <div id="gc-footer" --=""> 3721 <div class="text"> 3722 <p> 3723 Except as otherwise <a href="http://code.google.com/policies.html#restrictions">noted</a>, 3724 the content of this page is licensed under the <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons 3725 Attribution 3.0 License</a>, and code samples are licensed under the 3726 <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD License</a>. 3727 </p> 3728 <p> 3729 ©2011 Google 3730 </p> 3731 3732<!-- begin analytics --> 3733<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> 3734<script src="http://www.google-analytics.com/ga.js" type="text/javascript"></script> 3735 3736<script type="text/javascript"> 3737 // chrome doc tracking 3738 try { 3739 var engdocs = _gat._getTracker("YT-10763712-2"); 3740 engdocs._trackPageview(); 3741 } catch(err) {} 3742 3743 // code.google.com site-wide tracking 3744 try { 3745 _uacct="UA-18071-1"; 3746 _uanchor=1; 3747 _uff=0; 3748 urchinTracker(); 3749 } 3750 catch(e) {/* urchinTracker not available. */} 3751</script> 3752<!-- end analytics --> 3753 </div> 3754 </div> <!-- /gc-footer --> 3755 </div> <!-- /gc-container --> 3756</body></html> 3757
