diff options
Diffstat (limited to 'dom/webidl/XMLHttpRequest.webidl')
-rw-r--r-- | dom/webidl/XMLHttpRequest.webidl | 160 |
1 files changed, 160 insertions, 0 deletions
diff --git a/dom/webidl/XMLHttpRequest.webidl b/dom/webidl/XMLHttpRequest.webidl new file mode 100644 index 000000000..fa44c449f --- /dev/null +++ b/dom/webidl/XMLHttpRequest.webidl @@ -0,0 +1,160 @@ +/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this file, + * You can obtain one at http://mozilla.org/MPL/2.0/. + * + * The origin of this IDL file is + * www.w3.org/TR/2012/WD-XMLHttpRequest-20120117/ + * + * Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C + * liability, trademark and document use rules apply. + */ + +interface InputStream; +interface MozChannel; +interface IID; + +enum XMLHttpRequestResponseType { + "", + "arraybuffer", + "blob", + "document", + "json", + "text", + + // Mozilla-specific stuff + "moz-chunked-text", + "moz-chunked-arraybuffer", + "moz-blob" +}; + +/** + * Parameters for instantiating an XMLHttpRequest. They are passed as an + * optional argument to the constructor: + * + * new XMLHttpRequest({anon: true, system: true}); + */ +dictionary MozXMLHttpRequestParameters +{ + /** + * If true, the request will be sent without cookie and authentication + * headers. + */ + boolean mozAnon = false; + + /** + * If true, the same origin policy will not be enforced on the request. + */ + boolean mozSystem = false; +}; + +[Constructor(optional MozXMLHttpRequestParameters params), + // There are apparently callers, specifically CoffeeScript, who do + // things like this: + // c = new(window.ActiveXObject || XMLHttpRequest)("Microsoft.XMLHTTP") + // To handle that, we need a constructor that takes a string. + Constructor(DOMString ignored), + Exposed=(Window,DedicatedWorker,SharedWorker)] +interface XMLHttpRequest : XMLHttpRequestEventTarget { + // event handler + attribute EventHandler onreadystatechange; + + // states + const unsigned short UNSENT = 0; + const unsigned short OPENED = 1; + const unsigned short HEADERS_RECEIVED = 2; + const unsigned short LOADING = 3; + const unsigned short DONE = 4; + + readonly attribute unsigned short readyState; + + // request + [Throws] + void open(ByteString method, DOMString url); + [Throws] + void open(ByteString method, DOMString url, boolean async, + optional DOMString? user=null, optional DOMString? password=null); + [Throws] + void setRequestHeader(ByteString header, ByteString value); + + [SetterThrows] + attribute unsigned long timeout; + + [SetterThrows] + attribute boolean withCredentials; + + [Throws] + readonly attribute XMLHttpRequestUpload upload; + + [Throws] + void send(); + [Throws] + void send(ArrayBuffer data); + [Throws] + void send(ArrayBufferView data); + [Throws] + void send(Blob data); + [Throws] + void send(Document data); + [Throws] + void send(DOMString? data); + [Throws] + void send(FormData data); + [Throws] + void send(InputStream data); + [Throws] + void send(URLSearchParams data); + + [Throws] + void abort(); + + // response + readonly attribute DOMString responseURL; + + [Throws] + readonly attribute unsigned short status; + + [Throws] + readonly attribute ByteString statusText; + + [Throws] + ByteString? getResponseHeader(ByteString header); + + [Throws] + ByteString getAllResponseHeaders(); + + [Throws] + void overrideMimeType(DOMString mime); + + [SetterThrows] + attribute XMLHttpRequestResponseType responseType; + [Throws] + readonly attribute any response; + [Cached, Pure, Throws] + readonly attribute DOMString? responseText; + + [Throws, Exposed=Window] + readonly attribute Document? responseXML; + + // Mozilla-specific stuff + + [ChromeOnly, SetterThrows] + attribute boolean mozBackgroundRequest; + + [ChromeOnly, Exposed=Window] + readonly attribute MozChannel? channel; + + // A platform-specific identifer to represent the network interface + // which the HTTP request would occur on. + [ChromeOnly, Exposed=Window] + attribute ByteString? networkInterfaceId; + + [Throws, ChromeOnly, Exposed=Window] + any getInterface(IID iid); + + [ChromeOnly, Exposed=Window] + void setOriginAttributes(optional OriginAttributesDictionary originAttributes); + + readonly attribute boolean mozAnon; + readonly attribute boolean mozSystem; +}; |