sdk/lib/html/dart2js/html_dart2js.dart - Issue 11471005: Add documentation for HttpRequest.

Unified Diff: sdk/lib/html/dart2js/html_dart2js.dart

Issue 11471005: Add documentation for HttpRequest. (Closed) Base URL: http://dart.googlecode.com/svn/branches/bleeding_edge/dart/

Patch Set: Created 8 years ago

Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.

Jump to:

View side-by-side diff with in-line comments

Download patch

Index: sdk/lib/html/dart2js/html_dart2js.dart

===================================================================

--- sdk/lib/html/dart2js/html_dart2js.dart (revision 15801)

+++ sdk/lib/html/dart2js/html_dart2js.dart (working copy)

@@ -86,6 +86,7 @@

/// @domName HTMLAnchorElement; @docsEditable true

class AnchorElement extends Element implements Element native "*HTMLAnchorElement" {

+ ///@docsEditable true

factory AnchorElement({String href}) {

var e = document.$dom_createElement("a");

if (href != null) e.href = href;

@@ -339,6 +340,7 @@

/// @domName HTMLAreaElement; @docsEditable true

class AreaElement extends Element implements Element native "*HTMLAreaElement" {

+ ///@docsEditable true

factory AreaElement() => document.$dom_createElement("area");

/// @domName HTMLAreaElement.alt; @docsEditable true

@@ -391,6 +393,7 @@

/// @domName ArrayBuffer; @docsEditable true

class ArrayBuffer native "*ArrayBuffer" {

+ ///@docsEditable true

factory ArrayBuffer(int length) => _ArrayBufferFactoryProvider.createArrayBuffer(length);

/// @domName ArrayBuffer.byteLength; @docsEditable true

@@ -447,6 +450,7 @@

/// @domName HTMLAudioElement; @docsEditable true

class AudioElement extends MediaElement native "*HTMLAudioElement" {

+ ///@docsEditable true

factory AudioElement([String src]) {

if (!?src) {

return _AudioElementFactoryProvider.createAudioElement();

@@ -462,6 +466,7 @@

/// @domName HTMLBRElement; @docsEditable true

class BRElement extends Element implements Element native "*HTMLBRElement" {

+ ///@docsEditable true

factory BRElement() => document.$dom_createElement("br");

/// @domName HTMLBRElement.clear; @docsEditable true

@@ -486,6 +491,7 @@

/// @domName HTMLBaseElement; @docsEditable true

class BaseElement extends Element implements Element native "*HTMLBaseElement" {

+ ///@docsEditable true

factory BaseElement() => document.$dom_createElement("base");

/// @domName HTMLBaseElement.href; @docsEditable true

@@ -578,6 +584,7 @@

/// @domName Blob; @docsEditable true

class Blob native "*Blob" {

+ ///@docsEditable true

factory Blob(List blobParts, [String type, String endings]) {

if (!?type) {

return _BlobFactoryProvider.createBlob(blobParts);

@@ -605,6 +612,7 @@

/// @domName HTMLBodyElement; @docsEditable true

class BodyElement extends Element implements Element native "*HTMLBodyElement" {

+ ///@docsEditable true

factory BodyElement() => document.$dom_createElement("body");

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

@@ -664,6 +672,7 @@

/// @domName HTMLButtonElement; @docsEditable true

class ButtonElement extends Element implements Element native "*HTMLButtonElement" {

+ ///@docsEditable true

factory ButtonElement() => document.$dom_createElement("button");

/// @domName HTMLButtonElement.autofocus; @docsEditable true

@@ -734,6 +743,7 @@

/// @domName HTMLCanvasElement

class CanvasElement extends Element implements Element native "*HTMLCanvasElement" {

+ ///@docsEditable true

factory CanvasElement({int width, int height}) {

var e = document.$dom_createElement("canvas");

if (width != null) e.width = width;

@@ -1328,6 +1338,7 @@

/// @domName HTMLContentElement; @docsEditable true

class ContentElement extends Element implements Element native "*HTMLContentElement" {

+ ///@docsEditable true

factory ContentElement() => document.$dom_createElement("content");

/// @domName HTMLContentElement.resetStyleInheritance; @docsEditable true

@@ -1482,6 +1493,7 @@

/// @domName WebKitCSSMatrix; @docsEditable true

class CssMatrix native "*WebKitCSSMatrix" {

+ ///@docsEditable true

factory CssMatrix([String cssValue]) {

if (!?cssValue) {

return _CssMatrixFactoryProvider.createCssMatrix();

@@ -5132,6 +5144,7 @@

/// @domName HTMLDListElement; @docsEditable true

class DListElement extends Element implements Element native "*HTMLDListElement" {

+ ///@docsEditable true

factory DListElement() => document.$dom_createElement("dl");

/// @domName HTMLDListElement.compact; @docsEditable true

@@ -5145,6 +5158,7 @@

/// @domName HTMLDataListElement; @docsEditable true

class DataListElement extends Element implements Element native "*HTMLDataListElement" {

+ ///@docsEditable true

factory DataListElement() => document.$dom_createElement("datalist");

/// @domName HTMLDataListElement.options; @docsEditable true

@@ -5201,6 +5215,7 @@

/// @domName DataView; @docsEditable true

class DataView extends ArrayBufferView native "*DataView" {

+ ///@docsEditable true

factory DataView(ArrayBuffer buffer, [int byteOffset, int byteLength]) {

if (!?byteOffset) {

return _DataViewFactoryProvider.createDataView(buffer);

@@ -5352,6 +5367,7 @@

/// @domName HTMLDetailsElement; @docsEditable true

class DetailsElement extends Element implements Element native "*HTMLDetailsElement" {

+ ///@docsEditable true

factory DetailsElement() => document.$dom_createElement("details");

/// @domName HTMLDetailsElement.open; @docsEditable true

@@ -5532,9 +5548,31 @@

// BSD-style license that can be found in the LICENSE file.

+/**

+ * Represents an HTML <div> element.

+ *

+ * The [DivElement] is a generic container for content and does not have any

+ * special significance. It is functionally similar to [SpanElement].

+ *

+ * The [DivElement] is a block-level element, as opposed to [SpanElement],

+ * which is an inline-level element.

+ *

+ * Example usage:

+ *

+ * DivElement div = new DivElement();

+ * div.text = 'Here's my new DivElem

+ * document.body.elements.add(elem);

+ *

+ * See also:

+ *

+ * * [HTML <div> element](http://www.w3.org/TR/html-markup/div.html) from W3C.

+ * * [Block-level element](http://www.w3.org/TR/CSS2/visuren.html#block-boxes) from W3C.

+ * * [Inline-level element](http://www.w3.org/TR/CSS2/visuren.html#inline-boxes) from W3C.

+ */

/// @domName HTMLDivElement; @docsEditable true

class DivElement extends Element implements Element native "*HTMLDivElement" {

+ ///@docsEditable true

factory DivElement() => document.$dom_createElement("div");

}

@@ -5570,6 +5608,7 @@

/// @domName Document.cookie; @docsEditable true

String cookie;

+ /// Returns the [Window] associated with the document.

Kathy Walrath 2012/12/06 19:40:29 No need to link to [Window], since that's in the s

Emily Fortuna 2012/12/06 21:08:47 This actually wasn't one of my changes. It was add

Kathy Walrath 2012/12/06 22:53:14 No, let's keep this small. I'll make a note for la

/// @domName Document.defaultView; @docsEditable true

Window get window => _convertNativeToDart_Window(this._window);

@JSName('defaultView')

@@ -6382,6 +6421,7 @@

/// @domName DOMParser; @docsEditable true

class DomParser native "*DOMParser" {

+ ///@docsEditable true

factory DomParser() => _DomParserFactoryProvider.createDomParser();

/// @domName DOMParser.parseFromString; @docsEditable true

@@ -7740,6 +7780,7 @@

/// @domName HTMLEmbedElement; @docsEditable true

class EmbedElement extends Element implements Element native "*HTMLEmbedElement" {

+ ///@docsEditable true

factory EmbedElement() => document.$dom_createElement("embed");

/// @domName HTMLEmbedElement.align; @docsEditable true

@@ -8036,6 +8077,7 @@

/// @domName EventSource; @docsEditable true

class EventSource extends EventTarget native "*EventSource" {

+ ///@docsEditable true

factory EventSource(String scriptUrl) => _EventSourceFactoryProvider.createEventSource(scriptUrl);

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

@@ -8192,6 +8234,7 @@

/// @domName HTMLFieldSetElement; @docsEditable true

class FieldSetElement extends Element implements Element native "*HTMLFieldSetElement" {

+ ///@docsEditable true

factory FieldSetElement() => document.$dom_createElement("fieldset");

/// @domName HTMLFieldSetElement.disabled; @docsEditable true

@@ -8478,6 +8521,7 @@

/// @domName FileReader; @docsEditable true

class FileReader extends EventTarget native "*FileReader" {

+ ///@docsEditable true

factory FileReader() => _FileReaderFactoryProvider.createFileReader();

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

@@ -8552,6 +8596,7 @@

/// @domName FileReaderSync; @docsEditable true

class FileReaderSync native "*FileReaderSync" {

+ ///@docsEditable true

factory FileReaderSync() => _FileReaderSyncFactoryProvider.createFileReaderSync();

/// @domName FileReaderSync.readAsArrayBuffer; @docsEditable true

@@ -8981,6 +9026,7 @@

/// @domName FormData; @docsEditable true

class FormData native "*FormData" {

+ ///@docsEditable true

factory FormData([FormElement form]) {

if (!?form) {

return _FormDataFactoryProvider.createFormData();

@@ -8999,6 +9045,7 @@

/// @domName HTMLFormElement; @docsEditable true

class FormElement extends Element implements Element native "*HTMLFormElement" {

+ ///@docsEditable true

factory FormElement() => document.$dom_createElement("form");

/// @domName HTMLFormElement.acceptCharset; @docsEditable true

@@ -9197,6 +9244,7 @@

/// @domName HTMLHRElement; @docsEditable true

class HRElement extends Element implements Element native "*HTMLHRElement" {

+ ///@docsEditable true

factory HRElement() => document.$dom_createElement("hr");

/// @domName HTMLHRElement.align; @docsEditable true

@@ -9238,6 +9286,7 @@

/// @domName HTMLHeadElement; @docsEditable true

class HeadElement extends Element implements Element native "*HTMLHeadElement" {

+ ///@docsEditable true

factory HeadElement() => document.$dom_createElement("head");

/// @domName HTMLHeadElement.profile; @docsEditable true

@@ -9251,16 +9300,22 @@

/// @domName HTMLHeadingElement; @docsEditable true

class HeadingElement extends Element implements Element native "*HTMLHeadingElement" {

+ ///@docsEditable true

factory HeadingElement.h1() => document.$dom_createElement("h1");

+ ///@docsEditable true

factory HeadingElement.h2() => document.$dom_createElement("h2");

+ ///@docsEditable true

factory HeadingElement.h3() => document.$dom_createElement("h3");

+ ///@docsEditable true

factory HeadingElement.h4() => document.$dom_createElement("h4");

+ ///@docsEditable true

factory HeadingElement.h5() => document.$dom_createElement("h5");

+ ///@docsEditable true

factory HeadingElement.h6() => document.$dom_createElement("h6");

/// @domName HTMLHeadingElement.align; @docsEditable true

@@ -9597,6 +9652,7 @@

/// @domName HTMLHtmlElement; @docsEditable true

class HtmlElement extends Element implements Element native "*HTMLHtmlElement" {

+ ///@docsEditable true

factory HtmlElement() => document.$dom_createElement("html");

}

@@ -9627,19 +9683,66 @@

// BSD-style license that can be found in the LICENSE file.

-/// @domName XMLHttpRequest

+/// HttpRequest is a utility for retrieving data from a URL.

Kathy Walrath 2012/12/06 19:40:29 Does this generate OK? /// has been eating line en

Emily Fortuna 2012/12/06 21:08:47 Done.

+///

+/// HttpRequest can be used to obtain data from http, ftp, as well as file

Kathy Walrath 2012/12/06 19:40:29 as well as -> and

Emily Fortuna 2012/12/06 21:08:47 Done.

+/// protocols.

+///

+/// For example, suppose we're developing this Dart documentation page, and we

Kathy Walrath 2012/12/06 19:40:29 this Dart documentation page -> (something more ge

+/// wish to retrieve the html of the top level page and print it out.

Kathy Walrath 2012/12/06 19:40:29 html -> HTML top level -> top-level

Emily Fortuna 2012/12/06 21:08:47 Done.

+/// The easiest way to do that would be:

+///

+/// var httpRequest = HttpRequest.get('http://api.dartlang.org', (request) => print(request.responseText));

Kathy Walrath 2012/12/06 19:40:29 split into 2 lines?

Emily Fortuna 2012/12/06 21:08:47 Done.

+///

+/// It is important to note that with the default behavior of this class, your

+/// code making the request should be served from the same origin (domain name,

+/// port, and application layer protocol) as the url you are trying to access

Kathy Walrath 2012/12/06 19:40:29 url -> URL

Emily Fortuna 2012/12/06 21:08:47 Done.

+/// with HttpRequest. However, there are ways to

+/// [get around this restriction](http://www.dartlang.org/articles/json-web-service/#note-on-jsonp).

+///

+/// See also:

+/// [Dart article on using HttpRequests](http://www.dartlang.org/articles/json-web-service/#getting-data),

Kathy Walrath 2012/12/06 19:40:29 It'd be nice to make this a bulleted list by inser

Emily Fortuna 2012/12/06 21:08:47 Done.

+/// [JS XMLHttpRequest](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest),

+/// and [Using XMLHttpRequest](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest/Using_XMLHttpRequest)

+/// @domName XMLHttpRequest; @docsEditable true

class HttpRequest extends EventTarget native "*XMLHttpRequest" {

+ /// Construct a URL get request at the specified [url]. After

Kathy Walrath 2012/12/06 19:40:29 Construct -> Creates at -> for? Put the first se

Emily Fortuna 2012/12/06 21:08:47 Done.

+ /// completing the request, the object will call the user provided [onSuccess]

+ /// callback.

+ /// @docsEditable true

factory HttpRequest.get(String url, onComplete(HttpRequest request)) =>

_HttpRequestFactoryProvider.createHttpRequest_get(url, onComplete);

+ /// Construct a URL GET request at the specified [url] with

+ /// credentials such a cookie (already) set in the header or

+ /// (authorization headers)[http://tools.ietf.org/html/rfc1945#section-10.2].

+ /// After completing the request, the object will call the user provided [onSuccess]

+ /// callback.

+ ///

+ /// See also (authorization headers)[http://en.wikipedia.org/wiki/Basic_access_authentication].

+ /// @docsEditable true

factory HttpRequest.getWithCredentials(String url,

onComplete(HttpRequest request)) =>

_HttpRequestFactoryProvider.createHttpRequest_getWithCredentials(url,

onComplete);

+ /// General constructor for any type of request (GET, POST, etc). To be used

+ /// in conjunction with [open].

+ ///

+ /// var request = new HttpRequest();

+ /// request.open('GET', 'http://dartlang.org')

+ /// request.on.load.add((event) => print('Request complete'));

+ ///

+ /// is the (more verbose) equivalent of

+ ///

+ /// var request = new HttpRequest.get('http://dartlang.org', (event) => print('Request complete'));

+ ///@docsEditable true

factory HttpRequest() => _HttpRequestFactoryProvider.createHttpRequest();

+ /// Get the set of [HttpRequestEvents] that this request can respond to.

+ /// Usually used when adding an EventListener, such as in

+ /// `document.window.on.keyDown.add((e) => print('keydown happened'))`.

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

HttpRequestEvents get on =>

new HttpRequestEvents(this);

@@ -9657,13 +9760,27 @@

/// @domName XMLHttpRequest.readyState; @docsEditable true

final int readyState;

+ /// The data received as a reponse from the request.

+ ///

+ /// The data could be in the

+ /// form of a [String], [ArrayBuffer], [Document], [Blob], or json (also a

+ /// [String]). `null` indicates request failure.

/// @domName XMLHttpRequest.response; @docsEditable true

final Object response;

+ /// The response in string form or `null` on failure.

/// @domName XMLHttpRequest.responseText; @docsEditable true

final String responseText;

+ /// [String] telling the server the desired response format.

+ ///

+ /// Default is `String`.

+ /// Other options are one of 'arraybuffer', 'blob', 'document', 'json',

+ /// 'text'. Some newer browsers will throw NS_ERROR_DOM_INVALID_ACCESS_ERR if

+ /// `responseType` is set while performing a synchronous request.

+ ///

+ /// See also: [MDN responseType](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest#responseType)

/// @domName XMLHttpRequest.responseType; @docsEditable true

String responseType;

@@ -9671,18 +9788,30 @@

@JSName('responseXML')

final Document responseXml;

+ /// The http result code from the request (200, 404, etc).

+ /// See also: [Http Status Codes](http://en.wikipedia.org/wiki/List_of_HTTP_status_codes)

/// @domName XMLHttpRequest.status; @docsEditable true

final int status;

+ /// The request response string (such as "200 OK").

+ /// See also: [Http Status Codes](http://en.wikipedia.org/wiki/List_of_HTTP_status_codes)

/// @domName XMLHttpRequest.statusText; @docsEditable true

final String statusText;

+ /// [EventTarget] that can hold listeners to track the progress of the request.

+ /// The events fired will be members of [HttpRequestUploadEvents].

/// @domName XMLHttpRequest.upload; @docsEditable true

final HttpRequestUpload upload;

+ /// True if cross-site requests should use credentials such as cookies

+ /// or authorization headers; false otherwise. This value is ignored for

+ /// same-site requests.

/// @domName XMLHttpRequest.withCredentials; @docsEditable true

bool withCredentials;

+ /// Stop the current request. The request can only be stopped if readyState

+ /// is `HEADERS_RECIEVED` or `LOADING`. If this method is not in the process

+ /// of being sent, the method has no effect.

/// @domName XMLHttpRequest.abort; @docsEditable true

void abort() native;

@@ -9694,15 +9823,40 @@

@JSName('dispatchEvent')

bool $dom_dispatchEvent(Event evt) native;

+ /// Retrieve all the response headers from a request.

+ ///

+ /// `null` if no headers have been received. For multipart requests,

+ /// `getAllResponseHeaders` will return the response headers for the current

+ /// part of the request.

+ ///

+ /// See also [HTTP response headers](http://en.wikipedia.org/wiki/List_of_HTTP_header_fields#Responses)

+ /// for a list of common response headers.

/// @domName XMLHttpRequest.getAllResponseHeaders; @docsEditable true

String getAllResponseHeaders() native;

+ /// Return the response header named `header`, or `null` if not found.

+ ///

+ /// See also [HTTP response headers](http://en.wikipedia.org/wiki/List_of_HTTP_header_fields#Responses)

+ /// for a list of common response headers.

/// @domName XMLHttpRequest.getResponseHeader; @docsEditable true

String getResponseHeader(String header) native;

+ /// Specify the desired `url`, and `method` to use in making the request.

+ ///

+ /// By default the request is done asyncronously, with no user or password

+ /// authentication information. If `async` is false, the request will be send

+ /// synchronously.

+ ///

+ /// Calling `open` again on a currently active request is equivalent to

+ /// calling `abort`.

/// @domName XMLHttpRequest.open; @docsEditable true

void open(String method, String url, [bool async, String user, String password]) native;

+ /// Specify a particular MIME type (such as `text/xml`) desired for the

+ /// response.

+ ///

+ /// This value must be set before the request has been sent. See also the list

+ /// of [common MIME types](http://en.wikipedia.org/wiki/Internet_media_type#List_of_common_media_types)

/// @domName XMLHttpRequest.overrideMimeType; @docsEditable true

void overrideMimeType(String override) native;

@@ -9710,9 +9864,12 @@

@JSName('removeEventListener')

void $dom_removeEventListener(String type, EventListener listener, [bool useCapture]) native;

+ /// Send the request with any given `data`. See also

+ /// [MDN send() docs](https://developer.mozilla.org/en-US/docs/DOM/XMLHttpRequest#send()).

/// @domName XMLHttpRequest.send; @docsEditable true

void send([data]) native;

+ /// Sets HTTP `header` to `value`.

/// @domName XMLHttpRequest.setRequestHeader; @docsEditable true

void setRequestHeader(String header, String value) native;

@@ -9821,6 +9978,7 @@

/// @domName HTMLIFrameElement; @docsEditable true

class IFrameElement extends Element implements Element native "*HTMLIFrameElement" {

+ ///@docsEditable true

factory IFrameElement() => document.$dom_createElement("iframe");

/// @domName HTMLIFrameElement.align; @docsEditable true

@@ -9881,6 +10039,7 @@

/// @domName IceCandidate; @docsEditable true

class IceCandidate native "*IceCandidate" {

+ ///@docsEditable true

factory IceCandidate(String label, String candidateLine) => _IceCandidateFactoryProvider.createIceCandidate(label, candidateLine);

/// @domName IceCandidate.label; @docsEditable true

@@ -9914,6 +10073,7 @@

/// @domName HTMLImageElement; @docsEditable true

class ImageElement extends Element implements Element native "*HTMLImageElement" {

+ ///@docsEditable true

factory ImageElement({String src, int width, int height}) {

var e = document.$dom_createElement("img");

if (src != null) e.src = src;

@@ -9987,6 +10147,7 @@

/// @domName HTMLInputElement; @docsEditable true

class InputElement extends Element implements Element native "*HTMLInputElement" {

+ ///@docsEditable true

factory InputElement({String type}) {

var e = document.$dom_createElement("input");

if (type != null) e.type = type;

@@ -10682,6 +10843,7 @@

/// @domName HTMLKeygenElement; @docsEditable true

class KeygenElement extends Element implements Element native "*HTMLKeygenElement" {

+ ///@docsEditable true

factory KeygenElement() => document.$dom_createElement("keygen");

/// @domName HTMLKeygenElement.autofocus; @docsEditable true

@@ -10732,6 +10894,7 @@

/// @domName HTMLLIElement; @docsEditable true

class LIElement extends Element implements Element native "*HTMLLIElement" {

+ ///@docsEditable true

factory LIElement() => document.$dom_createElement("li");

/// @domName HTMLLIElement.type; @docsEditable true

@@ -10748,6 +10911,7 @@

/// @domName HTMLLabelElement; @docsEditable true

class LabelElement extends Element implements Element native "*HTMLLabelElement" {

+ ///@docsEditable true

factory LabelElement() => document.$dom_createElement("label");

/// @domName HTMLLabelElement.control; @docsEditable true

@@ -10767,6 +10931,7 @@

/// @domName HTMLLegendElement; @docsEditable true

class LegendElement extends Element implements Element native "*HTMLLegendElement" {

+ ///@docsEditable true

factory LegendElement() => document.$dom_createElement("legend");

/// @domName HTMLLegendElement.align; @docsEditable true

@@ -10783,6 +10948,7 @@

/// @domName HTMLLinkElement; @docsEditable true

class LinkElement extends Element implements Element native "*HTMLLinkElement" {

+ ///@docsEditable true

factory LinkElement() => document.$dom_createElement("link");

/// @domName HTMLLinkElement.charset; @docsEditable true

@@ -11505,6 +11671,7 @@

/// @domName HTMLMapElement; @docsEditable true

class MapElement extends Element implements Element native "*HTMLMapElement" {

+ ///@docsEditable true

factory MapElement() => document.$dom_createElement("map");

/// @domName HTMLMapElement.areas; @docsEditable true

@@ -11568,6 +11735,7 @@

/// @domName MediaController; @docsEditable true

class MediaController extends EventTarget native "*MediaController" {

+ ///@docsEditable true

factory MediaController() => _MediaControllerFactoryProvider.createMediaController();

/// @domName MediaController.buffered; @docsEditable true

@@ -11958,6 +12126,7 @@

/// @domName MediaSource; @docsEditable true

class MediaSource extends EventTarget native "*MediaSource" {

+ ///@docsEditable true

factory MediaSource() => _MediaSourceFactoryProvider.createMediaSource();

/// @domName MediaSource.activeSourceBuffers; @docsEditable true

@@ -12001,6 +12170,7 @@

/// @domName MediaStream; @docsEditable true

class MediaStream extends EventTarget native "*MediaStream" {

+ ///@docsEditable true

factory MediaStream(MediaStreamTrackList audioTracks, MediaStreamTrackList videoTracks) => _MediaStreamFactoryProvider.createMediaStream(audioTracks, videoTracks);

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

@@ -12181,9 +12351,20 @@

// BSD-style license that can be found in the LICENSE file.

+/**

+ * An HTML <menu> element.

+ *

+ * A <menu> element represents an unordered list of menu commands.

+ *

+ * See also:

+ *

+ * * [Menu Element](https://developer.mozilla.org/en-US/docs/HTML/Element/menu) from MDN.

+ * * [Menu Element](http://www.w3.org/TR/html5/the-menu-element.html#the-menu-element) from the W3C.

+ */

/// @domName HTMLMenuElement; @docsEditable true

class MenuElement extends Element implements Element native "*HTMLMenuElement" {

+ ///@docsEditable true

factory MenuElement() => document.$dom_createElement("menu");

}

@@ -12194,6 +12375,7 @@

/// @domName MessageChannel; @docsEditable true

class MessageChannel native "*MessageChannel" {

+ ///@docsEditable true

factory MessageChannel() => _MessageChannelFactoryProvider.createMessageChannel();

/// @domName MessageChannel.port1; @docsEditable true

@@ -12340,6 +12522,7 @@

/// @domName HTMLMeterElement; @docsEditable true

class MeterElement extends Element implements Element native "*HTMLMeterElement" {

+ ///@docsEditable true

factory MeterElement() => document.$dom_createElement("meter");

/// @domName HTMLMeterElement.high; @docsEditable true

@@ -12536,6 +12719,7 @@

/// @domName MutationObserver

class MutationObserver native "*MutationObserver" {

+ ///@docsEditable true

factory MutationObserver(MutationCallback callback) => _MutationObserverFactoryProvider.createMutationObserver(callback);

/// @domName MutationObserver.disconnect; @docsEditable true

@@ -13404,6 +13588,7 @@

/// @domName Notification; @docsEditable true

class Notification extends EventTarget native "*Notification" {

+ ///@docsEditable true

factory Notification(String title, [Map options]) {

if (!?options) {

return _NotificationFactoryProvider.createNotification(title);

@@ -13502,6 +13687,7 @@

/// @domName HTMLOListElement; @docsEditable true

class OListElement extends Element implements Element native "*HTMLOListElement" {

+ ///@docsEditable true

factory OListElement() => document.$dom_createElement("ol");

/// @domName HTMLOListElement.compact; @docsEditable true

@@ -13524,6 +13710,7 @@

/// @domName HTMLObjectElement; @docsEditable true

class ObjectElement extends Element implements Element native "*HTMLObjectElement" {

+ ///@docsEditable true

factory ObjectElement() => document.$dom_createElement("object");

/// @domName HTMLObjectElement.align; @docsEditable true

@@ -13652,6 +13839,7 @@

/// @domName HTMLOptGroupElement; @docsEditable true

class OptGroupElement extends Element implements Element native "*HTMLOptGroupElement" {

+ ///@docsEditable true

factory OptGroupElement() => document.$dom_createElement("optgroup");

/// @domName HTMLOptGroupElement.disabled; @docsEditable true

@@ -13668,6 +13856,7 @@

/// @domName HTMLOptionElement; @docsEditable true

class OptionElement extends Element implements Element native "*HTMLOptionElement" {

+ ///@docsEditable true

factory OptionElement([String data, String value, bool defaultSelected, bool selected]) {

if (!?data) {

return _OptionElementFactoryProvider.createOptionElement();

@@ -13713,6 +13902,7 @@

/// @domName HTMLOutputElement; @docsEditable true

class OutputElement extends Element implements Element native "*HTMLOutputElement" {

+ ///@docsEditable true

factory OutputElement() => document.$dom_createElement("output");

/// @domName HTMLOutputElement.defaultValue; @docsEditable true

@@ -13808,6 +13998,7 @@

/// @domName HTMLParagraphElement; @docsEditable true

class ParagraphElement extends Element implements Element native "*HTMLParagraphElement" {

+ ///@docsEditable true

factory ParagraphElement() => document.$dom_createElement("p");

/// @domName HTMLParagraphElement.align; @docsEditable true

@@ -13821,6 +14012,7 @@

/// @domName HTMLParamElement; @docsEditable true

class ParamElement extends Element implements Element native "*HTMLParamElement" {

+ ///@docsEditable true

factory ParamElement() => document.$dom_createElement("param");

/// @domName HTMLParamElement.name; @docsEditable true

@@ -13843,6 +14035,7 @@

/// @domName PeerConnection00; @docsEditable true

class PeerConnection00 extends EventTarget native "*PeerConnection00" {

+ ///@docsEditable true

factory PeerConnection00(String serverConfiguration, IceCallback iceCallback) => _PeerConnection00FactoryProvider.createPeerConnection00(serverConfiguration, iceCallback);

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

@@ -14183,6 +14376,7 @@

/// @domName HTMLPreElement; @docsEditable true

class PreElement extends Element implements Element native "*HTMLPreElement" {

+ ///@docsEditable true

factory PreElement() => document.$dom_createElement("pre");

/// @domName HTMLPreElement.width; @docsEditable true

@@ -14216,6 +14410,7 @@

/// @domName HTMLProgressElement; @docsEditable true

class ProgressElement extends Element implements Element native "*HTMLProgressElement" {

+ ///@docsEditable true

factory ProgressElement() => document.$dom_createElement("progress");

/// @domName HTMLProgressElement.labels; @docsEditable true

@@ -14557,6 +14752,7 @@

/// @domName RTCIceCandidate; @docsEditable true

class RtcIceCandidate native "*RTCIceCandidate" {

+ ///@docsEditable true

factory RtcIceCandidate(Map dictionary) => _RtcIceCandidateFactoryProvider.createRtcIceCandidate(dictionary);

/// @domName RTCIceCandidate.candidate; @docsEditable true

@@ -14587,6 +14783,7 @@

/// @domName RTCPeerConnection; @docsEditable true

class RtcPeerConnection extends EventTarget native "*RTCPeerConnection" {

+ ///@docsEditable true

factory RtcPeerConnection(Map rtcIceServers, [Map mediaConstraints]) {

if (!?mediaConstraints) {

return _RtcPeerConnectionFactoryProvider.createRtcPeerConnection(rtcIceServers);

@@ -14755,6 +14952,7 @@

/// @domName RTCSessionDescription; @docsEditable true

class RtcSessionDescription native "*RTCSessionDescription" {

+ ///@docsEditable true

factory RtcSessionDescription(Map dictionary) => _RtcSessionDescriptionFactoryProvider.createRtcSessionDescription(dictionary);

/// @domName RTCSessionDescription.sdp; @docsEditable true

@@ -14882,6 +15080,7 @@

/// @domName HTMLScriptElement; @docsEditable true

class ScriptElement extends Element implements Element native "*HTMLScriptElement" {

+ ///@docsEditable true

factory ScriptElement() => document.$dom_createElement("script");

/// @domName HTMLScriptElement.async; @docsEditable true

@@ -14969,6 +15168,7 @@

/// @domName HTMLSelectElement

class SelectElement extends Element implements Element native "*HTMLSelectElement" {

+ ///@docsEditable true

factory SelectElement() => document.$dom_createElement("select");

/// @domName HTMLSelectElement.autofocus; @docsEditable true

@@ -15053,6 +15253,7 @@

/// @domName SessionDescription; @docsEditable true

class SessionDescription native "*SessionDescription" {

+ ///@docsEditable true

factory SessionDescription(String sdp) => _SessionDescriptionFactoryProvider.createSessionDescription(sdp);

/// @domName SessionDescription.addCandidate; @docsEditable true

@@ -15082,6 +15283,7 @@

/// @domName ShadowRoot

class ShadowRoot extends DocumentFragment native "*ShadowRoot" {

+ ///@docsEditable true

factory ShadowRoot(Element host) => _ShadowRootFactoryProvider.createShadowRoot(host);

/// @domName ShadowRoot.activeElement; @docsEditable true

@@ -15129,6 +15331,7 @@

/// @domName SharedWorker; @docsEditable true

class SharedWorker extends AbstractWorker native "*SharedWorker" {

+ ///@docsEditable true

factory SharedWorker(String scriptURL, [String name]) {

if (!?name) {

return _SharedWorkerFactoryProvider.createSharedWorker(scriptURL);

@@ -15314,6 +15517,7 @@

/// @domName HTMLSourceElement; @docsEditable true

class SourceElement extends Element implements Element native "*HTMLSourceElement" {

+ ///@docsEditable true

factory SourceElement() => document.$dom_createElement("source");

/// @domName HTMLSourceElement.media; @docsEditable true

@@ -15333,6 +15537,7 @@

/// @domName HTMLSpanElement; @docsEditable true

class SpanElement extends Element implements Element native "*HTMLSpanElement" {

+ ///@docsEditable true

factory SpanElement() => document.$dom_createElement("span");

}

@@ -15343,6 +15548,7 @@

/// @domName SpeechGrammar; @docsEditable true

class SpeechGrammar native "*SpeechGrammar" {

+ ///@docsEditable true

factory SpeechGrammar() => _SpeechGrammarFactoryProvider.createSpeechGrammar();

/// @domName SpeechGrammar.src; @docsEditable true

@@ -15359,6 +15565,7 @@

/// @domName SpeechGrammarList; @docsEditable true

class SpeechGrammarList implements JavaScriptIndexingBehavior, List<SpeechGrammar> native "*SpeechGrammarList" {

+ ///@docsEditable true

factory SpeechGrammarList() => _SpeechGrammarListFactoryProvider.createSpeechGrammarList();

/// @domName SpeechGrammarList.length; @docsEditable true

@@ -15507,6 +15714,7 @@

/// @domName SpeechRecognition; @docsEditable true

class SpeechRecognition extends EventTarget native "*SpeechRecognition" {

+ ///@docsEditable true

factory SpeechRecognition() => _SpeechRecognitionFactoryProvider.createSpeechRecognition();

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

@@ -16042,6 +16250,7 @@

/// @domName HTMLStyleElement; @docsEditable true

class StyleElement extends Element implements Element native "*HTMLStyleElement" {

+ ///@docsEditable true

factory StyleElement() => document.$dom_createElement("style");

/// @domName HTMLStyleElement.disabled; @docsEditable true

@@ -16110,6 +16319,7 @@

/// @domName HTMLTableCaptionElement; @docsEditable true

class TableCaptionElement extends Element implements Element native "*HTMLTableCaptionElement" {

+ ///@docsEditable true

factory TableCaptionElement() => document.$dom_createElement("caption");

/// @domName HTMLTableCaptionElement.align; @docsEditable true

@@ -16123,6 +16333,7 @@

/// @domName HTMLTableCellElement; @docsEditable true

class TableCellElement extends Element implements Element native "*HTMLTableCellElement" {

+ ///@docsEditable true

factory TableCellElement() => document.$dom_createElement("td");

/// @domName HTMLTableCellElement.abbr; @docsEditable true

@@ -16178,6 +16389,7 @@

/// @domName HTMLTableColElement; @docsEditable true

class TableColElement extends Element implements Element native "*HTMLTableColElement" {

+ ///@docsEditable true

factory TableColElement() => document.$dom_createElement("col");

/// @domName HTMLTableColElement.align; @docsEditable true

@@ -16206,6 +16418,7 @@

/// @domName HTMLTableElement

class TableElement extends Element implements Element native "*HTMLTableElement" {

+ ///@docsEditable true

factory TableElement() => document.$dom_createElement("table");

/// @domName HTMLTableElement.align; @docsEditable true

@@ -16295,6 +16508,7 @@

/// @domName HTMLTableRowElement; @docsEditable true

class TableRowElement extends Element implements Element native "*HTMLTableRowElement" {

+ ///@docsEditable true

factory TableRowElement() => document.$dom_createElement("tr");

/// @domName HTMLTableRowElement.align; @docsEditable true

@@ -16385,6 +16599,7 @@

/// @domName HTMLTextAreaElement; @docsEditable true

class TextAreaElement extends Element implements Element native "*HTMLTextAreaElement" {

+ ///@docsEditable true

factory TextAreaElement() => document.$dom_createElement("textarea");

/// @domName HTMLTextAreaElement.autofocus; @docsEditable true

@@ -16559,6 +16774,7 @@

/// @domName TextTrackCue; @docsEditable true

class TextTrackCue extends EventTarget native "*TextTrackCue" {

+ ///@docsEditable true

factory TextTrackCue(num startTime, num endTime, String text) => _TextTrackCueFactoryProvider.createTextTrackCue(startTime, endTime, text);

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

@@ -16911,6 +17127,7 @@

/// @domName HTMLTitleElement; @docsEditable true

class TitleElement extends Element implements Element native "*HTMLTitleElement" {

+ ///@docsEditable true

factory TitleElement() => document.$dom_createElement("title");

}

@@ -17114,6 +17331,7 @@

/// @domName HTMLTrackElement; @docsEditable true

class TrackElement extends Element implements Element native "*HTMLTrackElement" {

+ ///@docsEditable true

factory TrackElement() => document.$dom_createElement("track");

static const int ERROR = 3;

@@ -17282,6 +17500,7 @@

/// @domName HTMLUListElement; @docsEditable true

class UListElement extends Element implements Element native "*HTMLUListElement" {

+ ///@docsEditable true

factory UListElement() => document.$dom_createElement("ul");

/// @domName HTMLUListElement.compact; @docsEditable true

@@ -17764,6 +17983,7 @@

/// @domName HTMLVideoElement; @docsEditable true

class VideoElement extends MediaElement native "*HTMLVideoElement" {

+ ///@docsEditable true

factory VideoElement() => document.$dom_createElement("video");

/// @domName HTMLVideoElement.height; @docsEditable true

@@ -19360,6 +19580,7 @@

/// @domName Worker; @docsEditable true

class Worker extends AbstractWorker native "*Worker" {

+ ///@docsEditable true

factory Worker(String scriptUrl) => _WorkerFactoryProvider.createWorker(scriptUrl);

/// @domName EventTarget.addEventListener, EventTarget.removeEventListener, EventTarget.dispatchEvent; @docsEditable true

@@ -19547,6 +19768,7 @@

/// @domName XPathEvaluator; @docsEditable true

class XPathEvaluator native "*XPathEvaluator" {

+ ///@docsEditable true

factory XPathEvaluator() => _XPathEvaluatorFactoryProvider.createXPathEvaluator();

/// @domName XPathEvaluator.createExpression; @docsEditable true

@@ -19668,6 +19890,7 @@

/// @domName XMLSerializer; @docsEditable true

class XmlSerializer native "*XMLSerializer" {

+ ///@docsEditable true

factory XmlSerializer() => _XmlSerializerFactoryProvider.createXmlSerializer();

/// @domName XMLSerializer.serializeToString; @docsEditable true

@@ -19681,6 +19904,7 @@

/// @domName XSLTProcessor; @docsEditable true

class XsltProcessor native "*XSLTProcessor" {

+ ///@docsEditable true

factory XsltProcessor() => _XsltProcessorFactoryProvider.createXsltProcessor();

/// @domName XSLTProcessor.clearParameters; @docsEditable true

« no previous file with comments | « no previous file | sdk/lib/html/dartium/html_dartium.dart » ('j') | no next file with comments »