Index: dart/tools/dom/docs/docs.json |
=================================================================== |
--- dart/tools/dom/docs/docs.json (revision 30037) |
+++ dart/tools/dom/docs/docs.json (working copy) |
@@ -2311,6 +2311,209 @@ |
" * This method is more efficient than `nodes.add`, and is the preferred", |
" * way of appending a child node.", |
" */" |
+ ], |
+ "childNodes": [ |
+ "/**", |
+ " * A list of this node's children.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.childNodes]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.childNodes)", |
+ " * from MDN.", |
+ " */" |
+ ], |
+ "cloneNode": [ |
+ "/**", |
+ " * Returns a copy of this node.", |
+ " *", |
+ " * If [deep] is `true`, then all of this node's children and decendents are", |
+ " * copied as well. If [deep] is `false`, then only this node is copied.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.cloneNode]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.cloneNode) from", |
+ " * MDN.", |
+ " */" |
+ ], |
+ "contains": [ |
+ "/**", |
+ " * Returns true if this node contains the specified node.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.contains]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.contains) from MDN.", |
+ " */" |
+ ], |
+ "firstChild": [ |
+ "/**", |
+ " * The first child of this node.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.firstChild]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.firstChild)", |
+ " * from MDN.", |
+ " */" |
+ ], |
+ "hasChildNodes": [ |
+ "/**", |
+ " * Returns true if this node has any children.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.hasChildNodes]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.hasChildNodes) from", |
+ " * MDN.", |
+ " */" |
+ ], |
+ "insertBefore": [ |
+ "/**", |
+ " * Inserts all of the nodes into this node directly before refChild.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.insertBefore]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.insertBefore) from", |
+ " * MDN.", |
+ " */" |
+ ], |
+ "lastChild": [ |
+ "/**", |
+ " * The last child of this node.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.lastChild]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.lastChild)", |
+ " * from MDN.", |
+ " */" |
+ ], |
+ "nextSibling": [ |
+ "/**", |
+ " * The next sibling node.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.nextSibling]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.nextSibling)", |
+ " * from MDN.", |
+ " */" |
+ ], |
+ "nodeName": [ |
+ "/**", |
+ " * The name of this node.", |
+ " *", |
+ " * This varies by this node's [nodeType].", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.nodeName]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.nodeName)", |
+ " * from MDN. This page contains a table of [nodeName] values for each", |
+ " * [nodeType].", |
+ " */" |
+ ], |
+ "nodeType": [ |
+ "/**", |
+ " * The type of node.", |
+ " *", |
+ " * This value is one of:", |
+ " *", |
+ " * * [ATTRIBUTE_NODE] if this node is an attribute.", |
+ " * * [CDATA_SECTION_NODE] if this node is a [CDataSection].", |
+ " * * [COMMENT_NODE] if this node is a [Comment].", |
+ " * * [DOCUMENT_FRAGMENT_NODE] if this node is a [DocumentFragment].", |
+ " * * [DOCUMENT_NODE] if this node is a [Document].", |
+ " * * [DOCUMENT_TYPE_NODE] if this node is a [DocumentType] node.", |
+ " * * [ELEMENT_NODE] if this node is an [Element].", |
+ " * * [ENTITY_NODE] if this node is an entity.", |
+ " * * [ENTITY_REFERENCE_NODE] if this node is an entity reference.", |
+ " * * [NOTATION_NODE] if this node is a notation.", |
+ " * * [PROCESSING_INSTRUCTION_NODE] if this node is a [ProcessingInstruction].", |
+ " * * [TEXT_NODE] if this node is a [Text] node.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.nodeType]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.nodeType) from MDN.", |
+ " */" |
+ ], |
+ "nodeValue": [ |
+ "/**", |
+ " * The value of this node.", |
+ " *", |
+ " * This varies by this type's [nodeType].", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.nodeValue]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.nodeValue)", |
+ " * from MDN. This page contains a table of [nodeValue] values for each", |
+ " * [nodeType].", |
+ " */" |
+ ], |
+ "ownerDocument": [ |
+ "/**", |
+ " * The document this node belongs to.", |
+ " *", |
+ " * Returns `null` if this node does not belong to any document.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.ownerDocument]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.ownerDocument) from", |
+ " * MDN.", |
+ " */" |
+ ], |
+ "parentElement": [ |
+ "/**", |
+ " * The parent element of this node.", |
+ " *", |
+ " * Returns `null` if this node either does not have a parent or its parent is", |
+ " * not an element.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.parentElement]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.parentElement) from", |
+ " * W3C.", |
+ " */" |
+ ], |
+ "parentNode": [ |
+ "/**", |
+ " * The parent node of this node.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.parentNode]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.parentNode) from", |
+ " * MDN.", |
+ " */" |
+ ], |
+ "previousSibling": [ |
+ "/**", |
+ " * The previous sibling node.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.previousSibling]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.previousSibling)", |
+ " * from MDN.", |
+ " */" |
+ ], |
+ "textContent": [ |
+ "/**", |
+ " * All text within this node and its decendents.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [Node.textContent]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/Node.textContent) from", |
+ " * MDN.", |
+ " */" |
] |
} |
}, |
@@ -2908,13 +3111,15 @@ |
" * Top-level container for the current browser tab or window.", |
" *", |
" * In a web browser, each window has a [Window] object, but within the context", |
- " * of a script, a [Window] object represents only the current window. In", |
- " * addition to the open window, each window, tab, and iframe has its own", |
- " * [Window] object. A [Window] contains a [Document] object, which contains this", |
- " * web page's content.", |
+ " * of a script, this object represents only the current window.", |
+ " * Each other window, tab, and iframe has its own [Window] object.", |
" *", |
- " * Use `window` to access properties of the current window. For example:", |
+ " * Each window contains a [Document] object, which contains all of the window's", |
+ " * content.", |
" *", |
+ " * Use the top-level `window` object to access the current window.", |
+ " * For example:", |
+ " *", |
" * // Draw a scene when the window repaints.", |
" * drawScene(num delta) {...}", |
" * window.animationFrame.then(drawScene);.", |
@@ -2923,9 +3128,13 @@ |
" * window.console.log('Jinkies!');", |
" * window.console.error('Jeepers!');", |
" *", |
- " * **Note:** This class represents the current window, whereas [WindowBase] is", |
- " * a representation of any window, including other tabs, windows, and frames.", |
+ " * **Note:** This class represents only the current window, while [WindowBase]", |
+ " * is a representation of any window, including other tabs, windows, and frames.", |
" *", |
+ " * ## See also", |
+ " *", |
+ " * * [WindowBase]", |
+ " *", |
" * ## Other resources", |
" *", |
" * * [DOM Window](https://developer.mozilla.org/en-US/docs/DOM/window) from MDN.", |
@@ -3419,12 +3628,33 @@ |
" * `send` method is intended only for more complext HTTP requests where", |
" * finer-grained control is needed.", |
" *", |
- " * See also:", |
+ " * ## Other resources", |
" *", |
- " * * [send](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest#send%28%29)", |
+ " * * [XMLHttpRequest.send]", |
+ " * (https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest#send%28%29)", |
" * from MDN.", |
" */" |
], |
+ "setRequestHeader": [ |
+ "/**", |
+ " * Sets the value of an HTTP requst header.", |
+ " *", |
+ " * This method should be called after the request is opened, but before", |
+ " * the request is sent.", |
+ " *", |
+ " * Multiple calls with the same header will combine all their values into a", |
+ " * single header.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [XMLHttpRequest.setRequestHeader]", |
+ " * (https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest#send%28%29)", |
+ " * from MDN.", |
+ " * * [The setRequestHeader() method]", |
+ " * (http://www.w3.org/TR/XMLHttpRequest/#the-setrequestheader()-method) from", |
+ " * W3C.", |
+ " */" |
+ ], |
"status": [ |
"/**", |
" * The http result code from the request (200, 404, etc).", |
@@ -3437,6 +3667,24 @@ |
" * See also: [Http Status Codes](http://en.wikipedia.org/wiki/List_of_HTTP_status_codes)", |
" */" |
], |
+ "timeout": [ |
+ "/**", |
+ " * Length of time before a request is automatically terminated.", |
+ " *", |
+ " * When the time has passed, a [TimeoutEvent] is dispatched.", |
+ " *", |
+ " * If [timeout] is set to 0, then the request will not time out.", |
+ " *", |
+ " * ## Other resources", |
+ " *", |
+ " * * [XMLHttpRequest.timeout]", |
+ " * (https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest#timeout)", |
+ " * from MDN.", |
+ " * * [The timeout attribute]", |
+ " * (http://www.w3.org/TR/XMLHttpRequest/#the-timeout-attribute)", |
+ " * from W3C.", |
+ " */" |
+ ], |
"upload": [ |
"/**", |
" * [EventTarget] that can hold listeners to track the progress of the request.", |