Window.close documentation.

sdk/lib/html/dart2js/html_dart2js.dart

 library html;
 
 import 'dart:isolate';
 import 'dart:json';
 import 'dart:svg' as svg;
 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 // DO NOT EDIT
@@ skipping 22166 matching lines @@
   /**
    * The current location of this window.
    *
    *     Location currentLocation = window.location;
    *     print(currentLocation.href); // 'http://www.example.com:80/'
    */
   Location get location;
   History get history;
 
   /**
-   * Indicates whether this window is closed.
+   * Indicates whether this window has been closed.
    *
    *     print(window.closed); // 'false'
    *     window.close();
    *     print(window.closed); // 'true'
    */
   bool get closed;
 
   /**
    * A reference to the window that opened this one.
    *
@@ skipping 32 matching lines @@
    *     myIFrame.elements.add(innerIFrame);
    *
    *     print(myIframe.contentWindow.top == window) // 'true'
    *     print(innerIFrame.contentWindow.top == window) // 'true'
    *
    *     print(window.top == window) // 'true'
    */
   Window get top;
 
   // Methods.
+  /**
+   * Closes the window.
+   *
+   * This method should only succeed if the [Window] object is
+   * **script-closeable** and the window calling [close] is allowed to navigate
+   * the window.
+   *
+   * A window is script-closeable if it is either a window
+   * that was opened by another window, or if it is a window with only one
+   * document in its history.
+   *
+   * A window might not be allowed to navigate, and therefore close, another
+   * window due to browser security features.
+   *
+   *     var other = window.open('http://www.example.com', 'foo');
+   *     // Closes other window, as it is script-closeable.
+   *     other.close();·

[Kathy Walrath, 2012/11/27 19:52:42]

I see a strange dot character at the end of this line (after the semicolon).
Could you delete it?

[Andrei Mouravski, 2012/11/27 20:39:26]

Done.

+   *     print(other.closed()); // 'true'
+   *
+   *     window.location('http://www.mysite.com', 'foo');
+   *     // Does not close this window, as the history has changed.
+   *     window.close();
+   *     print(window.closed()); // 'false'
+   *
+   * See also:
+   *
+   * * [DOM Window Close](http://www.w3.org/TR/html5/browsers.html#dom-window-close) from the W3C.

[Kathy Walrath, 2012/11/27 19:52:42]

DOM Window Close isn't a section title in the linked-to URL, which I expected
from the caps. How about changing it to something like "Window close()
discussion"

Also, no period after this item

[Andrei Mouravski, 2012/11/27 20:39:26]

Done.

+   */
   void close();
   void postMessage(var message, String targetOrigin, [List messagePorts = null]);
 }
 
 abstract class Location {
   void set href(String val);
 }
 
 abstract class History {
   void back();
@@ skipping 2836 matching lines @@
     if (length < 0) throw new ArgumentError('length');
     if (start < 0) throw new RangeError.value(start);
     int end = start + length;
     if (end > a.length) throw new RangeError.value(end);
     for (int i = start; i < end; i++) {
       accumulator.add(a[i]);
     }
     return accumulator;
   }
 }