From 168d493ea8854c6372088face256b4529a820d4b Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Tue, 3 Jul 2018 10:24:59 +0100 Subject: [PATCH 01/17] Introduce composedPath for Events --- baselines/dom.generated.d.ts | 2 +- baselines/webworker.generated.d.ts | 2 +- inputfiles/addedTypes.json | 6 +++--- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index bfb5e4c4a..bddde1cbe 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -4781,7 +4781,7 @@ interface Event { readonly target: EventTarget | null; readonly timeStamp: number; readonly type: string; - deepPath(): EventTarget[]; + composedPath(): EventTarget[]; initEvent(type: string, bubbles?: boolean, cancelable?: boolean): void; preventDefault(): void; stopImmediatePropagation(): void; diff --git a/baselines/webworker.generated.d.ts b/baselines/webworker.generated.d.ts index 20fc29eea..b644d2328 100644 --- a/baselines/webworker.generated.d.ts +++ b/baselines/webworker.generated.d.ts @@ -847,7 +847,7 @@ interface Event { readonly target: EventTarget | null; readonly timeStamp: number; readonly type: string; - deepPath(): EventTarget[]; + composedPath(): EventTarget[]; initEvent(type: string, bubbles?: boolean, cancelable?: boolean): void; preventDefault(): void; stopImmediatePropagation(): void; diff --git a/inputfiles/addedTypes.json b/inputfiles/addedTypes.json index 96bf70afe..3e53d6289 100644 --- a/inputfiles/addedTypes.json +++ b/inputfiles/addedTypes.json @@ -1126,10 +1126,10 @@ }, "methods": { "method": { - "deepPath": { - "name": "deepPath", + "composedPath": { + "name": "composedPath", "override-signatures": [ - "deepPath(): EventTarget[]" + "composedPath(): EventTarget[]" ] } } From 2d6bceffa0fd5fa21e97650264e0725e601553de Mon Sep 17 00:00:00 2001 From: 43081j <43081j@users.noreply.github.com> Date: Tue, 3 Jul 2018 20:53:52 +0100 Subject: [PATCH 02/17] add DOM IDL input files --- inputfiles/addedTypes.json | 22 -- inputfiles/idl/DOM.commentmap.json | 129 +++++++ inputfiles/idl/DOM.widl | 554 +++++++++++++++++++++++++++++ inputfiles/idlSources.json | 4 + 4 files changed, 687 insertions(+), 22 deletions(-) create mode 100644 inputfiles/idl/DOM.commentmap.json create mode 100644 inputfiles/idl/DOM.widl diff --git a/inputfiles/addedTypes.json b/inputfiles/addedTypes.json index 3e53d6289..4519431b5 100644 --- a/inputfiles/addedTypes.json +++ b/inputfiles/addedTypes.json @@ -1113,28 +1113,6 @@ } } }, - "Event": { - "name": "Event", - "properties": { - "property": { - "composed": { - "name": "composed", - "read-only": 1, - "override-type": "boolean" - } - } - }, - "methods": { - "method": { - "composedPath": { - "name": "composedPath", - "override-signatures": [ - "composedPath(): EventTarget[]" - ] - } - } - } - }, "ElementCreationOptions": { "name": "ElementCreationOptions", "exposed": "Window", diff --git a/inputfiles/idl/DOM.commentmap.json b/inputfiles/idl/DOM.commentmap.json new file mode 100644 index 000000000..f9af20aaf --- /dev/null +++ b/inputfiles/idl/DOM.commentmap.json @@ -0,0 +1,129 @@ +{ + "event-type": "Returns the type of event, e.g.\n\"click\", \"hashchange\", or\n\"submit\".", + "event-target": "Returns the object to which event is dispatched (its target).", + "event-currenttarget": "Returns the object whose event listener's callback is currently being\ninvoked.", + "event-stoppropagation": "When dispatched in a tree, invoking this method prevents event from reaching any objects other than the current object.", + "event-stopimmediatepropagation": "Invoking this method prevents event from reaching\nany registered event listeners after the current one finishes running and, when dispatched in a tree, also prevents event from reaching any\nother objects.", + "event-bubbles": "Returns true or false depending on how event was initialized. True if event goes through its target's ancestors in reverse tree order, and false otherwise.", + "event-composed": "Returns true or false depending on how event was initialized. True if event invokes listeners past a ShadowRoot node that is the root of its target, and false otherwise.", + "event-istrusted": "Returns true if event was dispatched by the user agent, and\nfalse otherwise.", + "event-timestamp": "Returns the event's timestamp as the number of milliseconds measured relative to\nthe time origin.", + "customevent-detail": "Returns any custom data event was created with.\nTypically used for synthetic events.", + "eventtarget-eventtarget": "Creates a new EventTarget object, which can be used by developers to dispatch and\nlisten for events.", + "eventtarget-addeventlistener": "Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.\nThe options argument sets listener-specific options. For compatibility this can be a\nboolean, in which case the method behaves exactly as if the value was specified as options's capture.\nWhen set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.\nWhen set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in §2.8 Observing event listeners.\nWhen set to true, options's once indicates that the callback will only be invoked once after which the event listener will\nbe removed.\nThe event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.", + "eventtarget-removeeventlistener": "Removes the event listener in target's event listener list with the same type, callback, and options.", + "eventtarget-dispatchevent": "Dispatches a synthetic event event to target and returns true\nif either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.", + "abortcontroller-signal": "Returns the AbortSignal object associated with this object.", + "abortcontroller-abort": "Invoking this method will set this object's AbortSignal's aborted flag and\nsignal to any observers that the associated activity is to be aborted.", + "abortsignal-aborted": "Returns true if this AbortSignal's AbortController has signaled to abort, and false\notherwise.", + "nonelementparentnode-getelementbyid": "Returns the first element within node's descendants whose ID is elementId.", + "parentnode-children": "Returns the child elements.", + "parentnode-firstelementchild": "Returns the first child that is an element, and null otherwise.", + "parentnode-lastelementchild": "Returns the last child that is an element, and null otherwise.", + "parentnode-prepend": "Inserts nodes before the first child of node, while\nreplacing strings in nodes with equivalent Text nodes.\nThrows a \"HierarchyRequestError\" DOMException if the constraints of\nthe node tree are violated.", + "parentnode-append": "Inserts nodes after the last child of node, while replacing\nstrings in nodes with equivalent Text nodes.\nThrows a \"HierarchyRequestError\" DOMException if the constraints of\nthe node tree are violated.", + "parentnode-queryselector": "Returns the first element that is a descendant of node that\nmatches selectors.", + "parentnode-queryselectorall": "Returns all element descendants of node that\nmatch selectors.", + "nondocumenttypechildnode-previouselementsibling": "Returns the first preceding sibling that\nis an element, and null otherwise.", + "nondocumenttypechildnode-nextelementsibling": "Returns the first following sibling that\nis an element, and null otherwise.", + "childnode-before": "Inserts nodes just before node, while replacing strings in nodes with equivalent Text nodes.\nThrows a \"HierarchyRequestError\" DOMException if the constraints of\nthe node tree are violated.", + "childnode-after": "Inserts nodes just after node, while replacing strings in nodes with equivalent Text nodes.\nThrows a \"HierarchyRequestError\" DOMException if the constraints of\nthe node tree are violated.", + "childnode-replacewith": "Replaces node with nodes, while replacing strings in nodes with equivalent Text nodes.\nThrows a \"HierarchyRequestError\" DOMException if the constraints of\nthe node tree are violated.", + "childnode-remove": "Removes node.", + "nodelist-length": "Returns the number of nodes in the collection.", + "nodelist-item": "element = collection[index]", + "htmlcollection-length": "Returns the number of elements in\nthe collection.", + "htmlcollection-item": "element = collection[index]", + "htmlcollection-nameditem": "element = collection[name]", + "mutationobserver-observe": "Instructs the user agent to observe a given target (a node) and report any mutations based on\nthe criteria given by options (an object).\nThe options argument allows for setting mutation\nobservation options via object members. These are the object members that\ncan be used:\nchildList\nSet to true if mutations to target's children are to be observed.\nattributes\nSet to true if mutations to target's attributes are to be observed. Can be omitted if attributeOldValue or attributeFilter is\nspecified.\ncharacterData\nSet to true if mutations to target's data are to be observed. Can be omitted if characterDataOldValue is specified.\nsubtree\nSet to true if mutations to not just target, but\nalso target's descendants are to be\nobserved.\nattributeOldValue\nSet to true if attributes is true or omitted\nand target's attribute value before the mutation\nneeds to be recorded.\ncharacterDataOldValue\nSet to true if characterData is set to true or omitted and target's data before the mutation\nneeds to be recorded.\nattributeFilter\nSet to a list of attribute local names (without namespace) if not all attribute mutations need to be\nobserved and attributes is true\nor omitted.", + "mutationobserver-takerecords": "Empties the record queue and\nreturns what was in there.", + "mutationrecord-type": "Returns \"attributes\" if it was an attribute mutation.\n\"characterData\" if it was a mutation to a CharacterData node. And\n\"childList\" if it was a mutation to the tree of nodes.", + "mutationrecord-removednodes": "Return the nodes added and removed\nrespectively.", + "mutationrecord-nextsibling": "Return the previous and next sibling respectively\nof the added or removed nodes, and null otherwise.", + "mutationrecord-attributename": "Returns the local name of the\nchanged attribute, and null otherwise.", + "mutationrecord-attributenamespace": "Returns the namespace of the\nchanged attribute, and null otherwise.", + "mutationrecord-oldvalue": "The return value depends on type. For\n\"attributes\", it is the value of the\nchanged attribute before the change.\nFor \"characterData\", it is the data of the changed node before the change. For\n\"childList\", it is null.", + "node-nodename": "Returns a string appropriate for the type of node, as\nfollows:\nElement\nIts HTML-uppercased qualified name.\nAttr\nIts qualified name.\nText\n\"#text\".\nCDATASection\n\"#cdata-section\".\nProcessingInstruction\nIts target.\nComment\n\"#comment\".\nDocument\n\"#document\".\nDocumentType\nIts name.\nDocumentFragment\n\"#document-fragment\".", + "node-baseuri": "Returns node's node document's document base URL.", + "node-isconnected": "Returns true if node is connected and false otherwise.", + "node-ownerdocument": "Returns the node document.\nReturns null for documents.", + "node-getrootnode": "Returns node's shadow-including root.", + "node-parentnode": "Returns the parent.", + "node-parentelement": "Returns the parent element.", + "node-haschildnodes": "Returns whether node has children.", + "node-childnodes": "Returns the children.", + "node-firstchild": "Returns the first child.", + "node-lastchild": "Returns the last child.", + "node-previoussibling": "Returns the previous sibling.", + "node-nextsibling": "Returns the next sibling.", + "node-normalize": "Removes empty exclusive Text nodes and concatenates the data of remaining contiguous exclusive Text nodes into the first of their nodes.", + "node-clonenode": "Returns a copy of node. If deep is true, the copy also includes the node's descendants.", + "node-isequalnode": "Returns whether node and otherNode have the same properties.", + "node-contains": "Returns true if other is an inclusive descendant of node, and false otherwise.", + "document-document": "Returns a new document.", + "document-implementation": "Returns a document, with a basic tree already constructed including a title element, unless the title argument is omitted.", + "document-documenturi": "Returns document's URL.", + "document-origin": "Returns document's origin.", + "document-compatmode": "Returns the string \"BackCompat\" if document's mode is \"quirks\", and \"CSS1Compat\"\notherwise.", + "document-characterset": "Returns document's encoding.", + "document-contenttype": "Returns document's content type.", + "document-doctype": "Returns the doctype or null if\nthere is none.", + "document-documentelement": "Returns the document element.", + "document-getelementsbytagname": "If qualifiedName is \"*\" returns a HTMLCollection of all descendant elements.\nOtherwise, returns a HTMLCollection of all descendant elements whose qualified name is qualifiedName. (Matches case-insensitively against elements in the HTML namespace within an HTML document.)", + "document-getelementsbytagnamens": "If namespace and localName are\n\"*\" returns a HTMLCollection of all descendant elements.\nIf only namespace is \"*\" returns a HTMLCollection of all descendant elements whose local name is localName.\nIf only localName is \"*\" returns a HTMLCollection of all descendant elements whose namespace is namespace.\nOtherwise, returns a HTMLCollection of all descendant elements whose namespace is namespace and local name is localName.", + "document-getelementsbyclassname": "collection = element . getElementsByClassName(classNames)", + "document-createelement": "Returns an element with localName as local name (if document is an HTML document, localName gets lowercased). The element's namespace is the HTML namespace when document is an HTML document or document's content type is \"application/xhtml+xml\", and null otherwise.\nIf localName does not match the Name production an\n\"InvalidCharacterError\" DOMException will be thrown.\nWhen supplied, options's is can be used to create a customized built-in element.", + "document-createelementns": "Returns an element with namespace namespace. Its namespace prefix will be everything before \":\" (U+003E) in qualifiedName or null. Its local name will be everything after\n\":\" (U+003E) in qualifiedName or qualifiedName.\nIf localName does not match the Name production an\n\"InvalidCharacterError\" DOMException will be thrown.\nIf one of the following conditions is true a \"NamespaceError\" DOMException will be thrown:\nlocalName does not match the QName production.\nNamespace prefix is not null and namespace is the empty string.\nNamespace prefix is \"xml\" and namespace is not the XML namespace.\nqualifiedName or namespace prefix is \"xmlns\" and namespace is not the XMLNS namespace.\nnamespace is the XMLNS namespace and\nneither qualifiedName nor namespace prefix is \"xmlns\".\nWhen supplied, options's is can be used to create a customized built-in element.", + "document-createdocumentfragment": "Returns a DocumentFragment node.", + "document-createtextnode": "Returns a Text node whose data is data.", + "document-createcdatasection": "Returns a CDATASection node whose data is data.", + "document-createcomment": "Returns a Comment node whose data is data.", + "document-createprocessinginstruction": "Returns a ProcessingInstruction node whose target is target and data is data.\nIf target does not match the Name production an\n\"InvalidCharacterError\" DOMException will be thrown.\nIf data contains \"?>\" an\n\"InvalidCharacterError\" DOMException will be thrown.", + "document-importnode": "", + "document-adoptnode": "Moves node from another document and returns it.\nIf node is a document, throws a \"NotSupportedError\" DOMException or, if node is a shadow root, throws a\n\"HierarchyRequestError\" DOMException.", + "documentfragment-documentfragment": "Returns a new DocumentFragment node.", + "element-namespaceuri": "Returns the namespace.", + "element-prefix": "Returns the namespace prefix.", + "element-localname": "Returns the local name.", + "element-tagname": "Returns the HTML-uppercased qualified name.", + "element-id": "Returns the value of element's id content attribute. Can be set to\nchange it.", + "element-classname": "Returns the value of element's class content attribute. Can be set\nto change it.", + "element-classlist": "Allows for manipulation of element's class content attribute as a\nset of whitespace-separated tokens through a DOMTokenList object.", + "element-slot": "Returns the value of element's slot content attribute. Can be set to\nchange it.", + "element-hasattributes": "Returns true if element has attributes, and false otherwise.", + "element-getattributenames": "Returns the qualified names of all element's attributes.\nCan contain duplicates.", + "element-getattribute": "Returns element's first attribute whose qualified name is qualifiedName, and null if there is no such attribute otherwise.", + "element-getattributens": "Returns element's attribute whose namespace is namespace and local name is localName, and null if there is\nno such attribute otherwise.", + "element-setattribute": "Sets the value of element's first attribute whose qualified name is qualifiedName to value.", + "element-setattributens": "Sets the value of element's attribute whose namespace is namespace and local name is localName to value.", + "element-removeattribute": "Removes element's first attribute whose qualified name is qualifiedName.", + "element-removeattributens": "Removes element's attribute whose namespace is namespace and local name is localName.", + "element-toggleattribute": "If force is not given, \"toggles\" qualifiedName, removing it if it is\npresent and adding it if it is not present. If force is true, adds qualifiedName. If force is false, removes qualifiedName.\nReturns true if qualifiedName is now present, and false otherwise.", + "element-hasattribute": "Returns true if element has an attribute whose qualified name is qualifiedName, and false otherwise.", + "element-hasattributens": "Returns true if element has an attribute whose namespace is namespace and local name is localName.", + "element-attachshadow": "Creates a shadow root for element and returns it.", + "element-shadowroot": "Returns element's shadow root, if any, and if shadow root's mode is \"open\", and null otherwise.", + "element-closest": "Returns the first (starting at element) inclusive ancestor that matches selectors, and null otherwise.", + "element-matches": "Returns true if matching selectors against element's root yields element, and false otherwise.", + "text-text": "Returns a new Text node whose data is data.", + "text-splittext": "Splits data at the given offset and returns the remainder as Text node.", + "text-wholetext": "Returns the combined data of all direct Text node siblings.", + "comment-comment": "Returns a new Comment node whose data is data.", + "range-startcontainer": "Returns range's start node.", + "range-startoffset": "Returns range's start offset.", + "range-endcontainer": "Returns range's end node.", + "range-endoffset": "Returns range's end offset.", + "range-collapsed": "Returns true if range is collapsed, and false otherwise.", + "range-range": "Returns a new live range.", + "range-commonancestorcontainer": "Returns the node, furthest away from\nthe document, that is an ancestor of both range's start node and end node.", + "range-comparepoint": "Returns −1 if the point is before the range, 0 if the point is\nin the range, and 1 if the point is after the range.", + "range-intersectsnode": "Returns whether range intersects node.", + "domtokenlist-length": "Returns the number of tokens.", + "domtokenlist-item": "tokenlist[index]", + "domtokenlist-contains": "Returns true if token is present, and false otherwise.", + "domtokenlist-add": "Adds all arguments passed, except those already present.\nThrows a \"SyntaxError\" DOMException if one of the arguments is the empty\nstring.\nThrows an \"InvalidCharacterError\" DOMException if one of the arguments\ncontains any ASCII whitespace.", + "domtokenlist-remove": "Removes arguments passed, if they are present.\nThrows a \"SyntaxError\" DOMException if one of the arguments is the empty\nstring.\nThrows an \"InvalidCharacterError\" DOMException if one of the arguments\ncontains any ASCII whitespace.", + "domtokenlist-replace": "Replaces token with newToken.\nReturns true if token was replaced with newToken, and false otherwise.\nThrows a \"SyntaxError\" DOMException if one of the arguments is the empty\nstring.\nThrows an \"InvalidCharacterError\" DOMException if one of the arguments\ncontains any ASCII whitespace.", + "domtokenlist-supports": "Returns true if token is in the associated attribute's supported tokens. Returns\nfalse otherwise.\nThrows a TypeError if the associated attribute has no supported tokens defined.", + "domtokenlist-value": "Returns the associated set as string.\nCan be set, to change the associated attribute." +} diff --git a/inputfiles/idl/DOM.widl b/inputfiles/idl/DOM.widl new file mode 100644 index 000000000..3a17f915c --- /dev/null +++ b/inputfiles/idl/DOM.widl @@ -0,0 +1,554 @@ +[Constructor(DOMString type, optional EventInit eventInitDict), + Exposed=(Window,Worker,AudioWorklet)] +interface Event { + readonly attribute DOMString type; + readonly attribute EventTarget? target; + readonly attribute EventTarget? srcElement; // historical + readonly attribute EventTarget? currentTarget; + sequence composedPath(); + + const unsigned short NONE = 0; + const unsigned short CAPTURING_PHASE = 1; + const unsigned short AT_TARGET = 2; + const unsigned short BUBBLING_PHASE = 3; + readonly attribute unsigned short eventPhase; + + void stopPropagation(); + attribute boolean cancelBubble; // historical alias of .stopPropagation + void stopImmediatePropagation(); + + readonly attribute boolean bubbles; + readonly attribute boolean cancelable; + attribute boolean returnValue; // historical + void preventDefault(); + readonly attribute boolean defaultPrevented; + readonly attribute boolean composed; + + [Unforgeable] readonly attribute boolean isTrusted; + readonly attribute DOMHighResTimeStamp timeStamp; + + void initEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false); // historical +}; + +dictionary EventInit { + boolean bubbles = false; + boolean cancelable = false; + boolean composed = false; +}; + +partial interface Window { + [Replaceable] readonly attribute any event; // historical +}; + +[Constructor(DOMString type, optional CustomEventInit eventInitDict), + Exposed=(Window,Worker)] +interface CustomEvent : Event { + readonly attribute any detail; + + void initCustomEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any detail = null); +}; + +dictionary CustomEventInit : EventInit { + any detail = null; +}; + +[Constructor, + Exposed=(Window,Worker,AudioWorklet)] +interface EventTarget { + void addEventListener(DOMString type, EventListener? callback, optional (AddEventListenerOptions or boolean) options); + void removeEventListener(DOMString type, EventListener? callback, optional (EventListenerOptions or boolean) options); + boolean dispatchEvent(Event event); +}; + +callback interface EventListener { + void handleEvent(Event event); +}; + +dictionary EventListenerOptions { + boolean capture = false; +}; + +dictionary AddEventListenerOptions : EventListenerOptions { + boolean passive = false; + boolean once = false; +}; + +[Constructor, + Exposed=(Window,Worker)] +interface AbortController { + [SameObject] readonly attribute AbortSignal signal; + + void abort(); +}; + +[Exposed=(Window,Worker)] +interface AbortSignal : EventTarget { + readonly attribute boolean aborted; + + attribute EventHandler onabort; +}; + +interface mixin NonElementParentNode { + Element? getElementById(DOMString elementId); +}; +Document includes NonElementParentNode; +DocumentFragment includes NonElementParentNode; + +interface mixin DocumentOrShadowRoot { +}; +Document includes DocumentOrShadowRoot; +ShadowRoot includes DocumentOrShadowRoot; + +interface mixin ParentNode { + [SameObject] readonly attribute HTMLCollection children; + readonly attribute Element? firstElementChild; + readonly attribute Element? lastElementChild; + readonly attribute unsigned long childElementCount; + + [CEReactions, Unscopable] void prepend((Node or DOMString)... nodes); + [CEReactions, Unscopable] void append((Node or DOMString)... nodes); + + Element? querySelector(DOMString selectors); + [NewObject] NodeList querySelectorAll(DOMString selectors); +}; +Document includes ParentNode; +DocumentFragment includes ParentNode; +Element includes ParentNode; + +interface mixin NonDocumentTypeChildNode { + readonly attribute Element? previousElementSibling; + readonly attribute Element? nextElementSibling; +}; +Element includes NonDocumentTypeChildNode; +CharacterData includes NonDocumentTypeChildNode; + +interface mixin ChildNode { + [CEReactions, Unscopable] void before((Node or DOMString)... nodes); + [CEReactions, Unscopable] void after((Node or DOMString)... nodes); + [CEReactions, Unscopable] void replaceWith((Node or DOMString)... nodes); + [CEReactions, Unscopable] void remove(); +}; +DocumentType includes ChildNode; +Element includes ChildNode; +CharacterData includes ChildNode; + +interface mixin Slotable { + readonly attribute HTMLSlotElement? assignedSlot; +}; +Element includes Slotable; +Text includes Slotable; + +[Exposed=Window] +interface NodeList { + getter Node? item(unsigned long index); + readonly attribute unsigned long length; + iterable; +}; + +[Exposed=Window, LegacyUnenumerableNamedProperties] +interface HTMLCollection { + readonly attribute unsigned long length; + getter Element? item(unsigned long index); + getter Element? namedItem(DOMString name); +}; + +[Constructor(MutationCallback callback), + Exposed=Window] +interface MutationObserver { + void observe(Node target, optional MutationObserverInit options); + void disconnect(); + sequence takeRecords(); +}; + +callback MutationCallback = void (sequence mutations, MutationObserver observer); + +dictionary MutationObserverInit { + boolean childList = false; + boolean attributes; + boolean characterData; + boolean subtree = false; + boolean attributeOldValue; + boolean characterDataOldValue; + sequence attributeFilter; +}; + +[Exposed=Window] +interface MutationRecord { + readonly attribute DOMString type; + [SameObject] readonly attribute Node target; + [SameObject] readonly attribute NodeList addedNodes; + [SameObject] readonly attribute NodeList removedNodes; + readonly attribute Node? previousSibling; + readonly attribute Node? nextSibling; + readonly attribute DOMString? attributeName; + readonly attribute DOMString? attributeNamespace; + readonly attribute DOMString? oldValue; +}; + +[Exposed=Window] +interface Node : EventTarget { + const unsigned short ELEMENT_NODE = 1; + const unsigned short ATTRIBUTE_NODE = 2; + const unsigned short TEXT_NODE = 3; + const unsigned short CDATA_SECTION_NODE = 4; + const unsigned short ENTITY_REFERENCE_NODE = 5; // historical + const unsigned short ENTITY_NODE = 6; // historical + const unsigned short PROCESSING_INSTRUCTION_NODE = 7; + const unsigned short COMMENT_NODE = 8; + const unsigned short DOCUMENT_NODE = 9; + const unsigned short DOCUMENT_TYPE_NODE = 10; + const unsigned short DOCUMENT_FRAGMENT_NODE = 11; + const unsigned short NOTATION_NODE = 12; // historical + readonly attribute unsigned short nodeType; + readonly attribute DOMString nodeName; + + readonly attribute USVString baseURI; + + readonly attribute boolean isConnected; + readonly attribute Document? ownerDocument; + Node getRootNode(optional GetRootNodeOptions options); + readonly attribute Node? parentNode; + readonly attribute Element? parentElement; + boolean hasChildNodes(); + [SameObject] readonly attribute NodeList childNodes; + readonly attribute Node? firstChild; + readonly attribute Node? lastChild; + readonly attribute Node? previousSibling; + readonly attribute Node? nextSibling; + + [CEReactions] attribute DOMString? nodeValue; + [CEReactions] attribute DOMString? textContent; + [CEReactions] void normalize(); + + [CEReactions, NewObject] Node cloneNode(optional boolean deep = false); + boolean isEqualNode(Node? otherNode); + boolean isSameNode(Node? otherNode); // historical alias of === + + const unsigned short DOCUMENT_POSITION_DISCONNECTED = 0x01; + const unsigned short DOCUMENT_POSITION_PRECEDING = 0x02; + const unsigned short DOCUMENT_POSITION_FOLLOWING = 0x04; + const unsigned short DOCUMENT_POSITION_CONTAINS = 0x08; + const unsigned short DOCUMENT_POSITION_CONTAINED_BY = 0x10; + const unsigned short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20; + unsigned short compareDocumentPosition(Node other); + boolean contains(Node? other); + + DOMString? lookupPrefix(DOMString? namespace); + DOMString? lookupNamespaceURI(DOMString? prefix); + boolean isDefaultNamespace(DOMString? namespace); + + [CEReactions] Node insertBefore(Node node, Node? child); + [CEReactions] Node appendChild(Node node); + [CEReactions] Node replaceChild(Node node, Node child); + [CEReactions] Node removeChild(Node child); +}; + +dictionary GetRootNodeOptions { + boolean composed = false; +}; + +[Constructor, + Exposed=Window] +interface Document : Node { + [SameObject] readonly attribute DOMImplementation implementation; + readonly attribute USVString URL; + readonly attribute USVString documentURI; + readonly attribute USVString origin; + readonly attribute DOMString compatMode; + readonly attribute DOMString characterSet; + readonly attribute DOMString charset; // historical alias of .characterSet + readonly attribute DOMString inputEncoding; // historical alias of .characterSet + readonly attribute DOMString contentType; + + readonly attribute DocumentType? doctype; + readonly attribute Element? documentElement; + HTMLCollection getElementsByTagName(DOMString qualifiedName); + HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName); + HTMLCollection getElementsByClassName(DOMString classNames); + + [CEReactions, NewObject] Element createElement(DOMString localName, optional (DOMString or ElementCreationOptions) options); + [CEReactions, NewObject] Element createElementNS(DOMString? namespace, DOMString qualifiedName, optional (DOMString or ElementCreationOptions) options); + [NewObject] DocumentFragment createDocumentFragment(); + [NewObject] Text createTextNode(DOMString data); + [NewObject] CDATASection createCDATASection(DOMString data); + [NewObject] Comment createComment(DOMString data); + [NewObject] ProcessingInstruction createProcessingInstruction(DOMString target, DOMString data); + + [CEReactions, NewObject] Node importNode(Node node, optional boolean deep = false); + [CEReactions] Node adoptNode(Node node); + + [NewObject] Attr createAttribute(DOMString localName); + [NewObject] Attr createAttributeNS(DOMString? namespace, DOMString qualifiedName); + + [NewObject] Event createEvent(DOMString interface); + + [NewObject] Range createRange(); + + // NodeFilter.SHOW_ALL = 0xFFFFFFFF + [NewObject] NodeIterator createNodeIterator(Node root, optional unsigned long whatToShow = 0xFFFFFFFF, optional NodeFilter? filter = null); + [NewObject] TreeWalker createTreeWalker(Node root, optional unsigned long whatToShow = 0xFFFFFFFF, optional NodeFilter? filter = null); +}; + +[Exposed=Window] +interface XMLDocument : Document {}; + +dictionary ElementCreationOptions { + DOMString is; +}; + +[Exposed=Window] +interface DOMImplementation { + [NewObject] DocumentType createDocumentType(DOMString qualifiedName, DOMString publicId, DOMString systemId); + [NewObject] XMLDocument createDocument(DOMString? namespace, [TreatNullAs=EmptyString] DOMString qualifiedName, optional DocumentType? doctype = null); + [NewObject] Document createHTMLDocument(optional DOMString title); + + boolean hasFeature(); // useless; always returns true +}; + +[Exposed=Window] +interface DocumentType : Node { + readonly attribute DOMString name; + readonly attribute DOMString publicId; + readonly attribute DOMString systemId; +}; + +[Constructor, + Exposed=Window] +interface DocumentFragment : Node { +}; + +[Exposed=Window] +interface ShadowRoot : DocumentFragment { + readonly attribute ShadowRootMode mode; + readonly attribute Element host; +}; + +enum ShadowRootMode { "open", "closed" }; + +[Exposed=Window] +interface Element : Node { + readonly attribute DOMString? namespaceURI; + readonly attribute DOMString? prefix; + readonly attribute DOMString localName; + readonly attribute DOMString tagName; + + [CEReactions] attribute DOMString id; + [CEReactions] attribute DOMString className; + [SameObject, PutForwards=value] readonly attribute DOMTokenList classList; + [CEReactions, Unscopable] attribute DOMString slot; + + boolean hasAttributes(); + [SameObject] readonly attribute NamedNodeMap attributes; + sequence getAttributeNames(); + DOMString? getAttribute(DOMString qualifiedName); + DOMString? getAttributeNS(DOMString? namespace, DOMString localName); + [CEReactions] void setAttribute(DOMString qualifiedName, DOMString value); + [CEReactions] void setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value); + [CEReactions] void removeAttribute(DOMString qualifiedName); + [CEReactions] void removeAttributeNS(DOMString? namespace, DOMString localName); + [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force); + boolean hasAttribute(DOMString qualifiedName); + boolean hasAttributeNS(DOMString? namespace, DOMString localName); + + Attr? getAttributeNode(DOMString qualifiedName); + Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName); + [CEReactions] Attr? setAttributeNode(Attr attr); + [CEReactions] Attr? setAttributeNodeNS(Attr attr); + [CEReactions] Attr removeAttributeNode(Attr attr); + + ShadowRoot attachShadow(ShadowRootInit init); + readonly attribute ShadowRoot? shadowRoot; + + Element? closest(DOMString selectors); + boolean matches(DOMString selectors); + boolean webkitMatchesSelector(DOMString selectors); // historical alias of .matches + + HTMLCollection getElementsByTagName(DOMString qualifiedName); + HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName); + HTMLCollection getElementsByClassName(DOMString classNames); + + [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // historical + void insertAdjacentText(DOMString where, DOMString data); // historical +}; + +dictionary ShadowRootInit { + required ShadowRootMode mode; +}; + +[Exposed=Window, + LegacyUnenumerableNamedProperties] +interface NamedNodeMap { + readonly attribute unsigned long length; + getter Attr? item(unsigned long index); + getter Attr? getNamedItem(DOMString qualifiedName); + Attr? getNamedItemNS(DOMString? namespace, DOMString localName); + [CEReactions] Attr? setNamedItem(Attr attr); + [CEReactions] Attr? setNamedItemNS(Attr attr); + [CEReactions] Attr removeNamedItem(DOMString qualifiedName); + [CEReactions] Attr removeNamedItemNS(DOMString? namespace, DOMString localName); +}; + +[Exposed=Window] +interface Attr : Node { + readonly attribute DOMString? namespaceURI; + readonly attribute DOMString? prefix; + readonly attribute DOMString localName; + readonly attribute DOMString name; + [CEReactions] attribute DOMString value; + + readonly attribute Element? ownerElement; + + readonly attribute boolean specified; // useless; always returns true +}; + +[Exposed=Window] +interface CharacterData : Node { + attribute [TreatNullAs=EmptyString] DOMString data; + readonly attribute unsigned long length; + DOMString substringData(unsigned long offset, unsigned long count); + void appendData(DOMString data); + void insertData(unsigned long offset, DOMString data); + void deleteData(unsigned long offset, unsigned long count); + void replaceData(unsigned long offset, unsigned long count, DOMString data); +}; + +[Constructor(optional DOMString data = ""), + Exposed=Window] +interface Text : CharacterData { + [NewObject] Text splitText(unsigned long offset); + readonly attribute DOMString wholeText; +}; + +[Exposed=Window] +interface CDATASection : Text { +}; + +[Exposed=Window] +interface ProcessingInstruction : CharacterData { + readonly attribute DOMString target; +}; + +[Constructor(optional DOMString data = ""), + Exposed=Window] +interface Comment : CharacterData { +}; + +[Exposed=Window] +interface AbstractRange { + readonly attribute Node startContainer; + readonly attribute unsigned long startOffset; + readonly attribute Node endContainer; + readonly attribute unsigned long endOffset; + readonly attribute boolean collapsed; +}; + +[Exposed=Window] +interface StaticRange : AbstractRange { +}; + +[Constructor, + Exposed=Window] +interface Range : AbstractRange { + readonly attribute Node commonAncestorContainer; + + void setStart(Node node, unsigned long offset); + void setEnd(Node node, unsigned long offset); + void setStartBefore(Node node); + void setStartAfter(Node node); + void setEndBefore(Node node); + void setEndAfter(Node node); + void collapse(optional boolean toStart = false); + void selectNode(Node node); + void selectNodeContents(Node node); + + const unsigned short START_TO_START = 0; + const unsigned short START_TO_END = 1; + const unsigned short END_TO_END = 2; + const unsigned short END_TO_START = 3; + short compareBoundaryPoints(unsigned short how, Range sourceRange); + + [CEReactions] void deleteContents(); + [CEReactions, NewObject] DocumentFragment extractContents(); + [CEReactions, NewObject] DocumentFragment cloneContents(); + [CEReactions] void insertNode(Node node); + [CEReactions] void surroundContents(Node newParent); + + [NewObject] Range cloneRange(); + void detach(); + + boolean isPointInRange(Node node, unsigned long offset); + short comparePoint(Node node, unsigned long offset); + + boolean intersectsNode(Node node); + + stringifier; +}; + +[Exposed=Window] +interface NodeIterator { + [SameObject] readonly attribute Node root; + readonly attribute Node referenceNode; + readonly attribute boolean pointerBeforeReferenceNode; + readonly attribute unsigned long whatToShow; + readonly attribute NodeFilter? filter; + + Node? nextNode(); + Node? previousNode(); + + void detach(); +}; + +[Exposed=Window] +interface TreeWalker { + [SameObject] readonly attribute Node root; + readonly attribute unsigned long whatToShow; + readonly attribute NodeFilter? filter; + attribute Node currentNode; + + Node? parentNode(); + Node? firstChild(); + Node? lastChild(); + Node? previousSibling(); + Node? nextSibling(); + Node? previousNode(); + Node? nextNode(); +}; + +[Exposed=Window] +callback interface NodeFilter { + // Constants for acceptNode() + const unsigned short FILTER_ACCEPT = 1; + const unsigned short FILTER_REJECT = 2; + const unsigned short FILTER_SKIP = 3; + + // Constants for whatToShow + const unsigned long SHOW_ALL = 0xFFFFFFFF; + const unsigned long SHOW_ELEMENT = 0x1; + const unsigned long SHOW_ATTRIBUTE = 0x2; + const unsigned long SHOW_TEXT = 0x4; + const unsigned long SHOW_CDATA_SECTION = 0x8; + const unsigned long SHOW_ENTITY_REFERENCE = 0x10; // historical + const unsigned long SHOW_ENTITY = 0x20; // historical + const unsigned long SHOW_PROCESSING_INSTRUCTION = 0x40; + const unsigned long SHOW_COMMENT = 0x80; + const unsigned long SHOW_DOCUMENT = 0x100; + const unsigned long SHOW_DOCUMENT_TYPE = 0x200; + const unsigned long SHOW_DOCUMENT_FRAGMENT = 0x400; + const unsigned long SHOW_NOTATION = 0x800; // historical + + unsigned short acceptNode(Node node); +}; + +[Exposed=Window] +interface DOMTokenList { + readonly attribute unsigned long length; + getter DOMString? item(unsigned long index); + boolean contains(DOMString token); + [CEReactions] void add(DOMString... tokens); + [CEReactions] void remove(DOMString... tokens); + [CEReactions] boolean toggle(DOMString token, optional boolean force); + [CEReactions] boolean replace(DOMString token, DOMString newToken); + boolean supports(DOMString token); + [CEReactions] stringifier attribute DOMString value; + iterable; +}; diff --git a/inputfiles/idlSources.json b/inputfiles/idlSources.json index 434b0bd9a..061b0fec9 100644 --- a/inputfiles/idlSources.json +++ b/inputfiles/idlSources.json @@ -16,6 +16,10 @@ "url": "https://www.w3.org/TR/css-transitions-1/", "title": "CSS Transitions" }, + { + "url": "https://dom.spec.whatwg.org/", + "title": "DOM" + }, { "url": "https://encoding.spec.whatwg.org/", "title": "Encoding" From d5f035f29835e2398a02c3876a43d76bc821008c Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Thu, 5 Jul 2018 11:26:04 +0100 Subject: [PATCH 03/17] add HTML IDL files --- inputfiles/comments.json | 298 +++++++++++++++++++++------------------ 1 file changed, 157 insertions(+), 141 deletions(-) diff --git a/inputfiles/comments.json b/inputfiles/comments.json index e3cc2b2b0..463712dba 100644 --- a/inputfiles/comments.json +++ b/inputfiles/comments.json @@ -1,4 +1,152 @@ { + "mixins": { + "mixin": { + "GlobalEventHandlers": { + "properties": { + "property": { + "ondragleave": { + "comment": "/**\r\n * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.\r\n * @param ev The drag event.\r\n */" + }, + "ondragenter": { + "comment": "/**\r\n * Fires on the target element when the user drags the object to a valid drop target.\r\n * @param ev The drag event.\r\n */" + }, + "ondragend": { + "comment": "/**\r\n * Fires on the source object when the user releases the mouse at the close of a drag operation.\r\n * @param ev The event.\r\n */" + }, + "ondragover": { + "comment": "/**\r\n * Fires on the target element continuously while the user drags the object over a valid drop target.\r\n * @param ev The event.\r\n */" + }, + "ondragstart": { + "comment": "/**\r\n * Fires on the source object when the user starts to drag a text selection or selected object.\r\n * @param ev The event.\r\n */" + }, + "ondrag": { + "comment": "/**\r\n * Fires on the source object continuously during a drag operation.\r\n * @param ev The event.\r\n */" + }, + "onseeked": { + "comment": "/**\r\n * Occurs when the seek operation ends.\r\n * @param ev The event.\r\n */" + }, + "onseeking": { + "comment": "/**\r\n * Occurs when the current playback position is moved.\r\n * @param ev The event.\r\n */" + }, + "onreset": { + "comment": "/**\r\n * Fires when the user resets a form.\r\n * @param ev The event.\r\n */" + }, + "onkeydown": { + "comment": "/**\r\n * Fires when the user presses a key.\r\n * @param ev The keyboard event\r\n */" + }, + "onkeyup": { + "comment": "/**\r\n * Fires when the user releases a key.\r\n * @param ev The keyboard event\r\n */" + }, + "ondurationchange": { + "comment": "/**\r\n * Occurs when the duration attribute is updated.\r\n * @param ev The event.\r\n */" + }, + "onblur": { + "comment": "/**\r\n * Fires when the object loses the input focus.\r\n * @param ev The focus event.\r\n */" + }, + "onload": { + "comment": "/**\r\n * Fires immediately after the browser loads the object.\r\n * @param ev The event.\r\n */" + }, + "onscroll": { + "comment": "/**\r\n * Fires when the user repositions the scroll box in the scroll bar on the object.\r\n * @param ev The event.\r\n */" + }, + "onpause": { + "comment": "/**\r\n * Occurs when playback is paused.\r\n * @param ev The event.\r\n */" + }, + "onmousedown": { + "comment": "/**\r\n * Fires when the user clicks the object with either mouse button.\r\n * @param ev The mouse event.\r\n */" + }, + "onclick": { + "comment": "/**\r\n * Fires when the user clicks the left mouse button on the object\r\n * @param ev The mouse event.\r\n */" + }, + "onwaiting": { + "comment": "/**\r\n * Occurs when playback stops because the next frame of a video resource is not available.\r\n * @param ev The event.\r\n */" + }, + "onkeypress": { + "comment": "/**\r\n * Fires when the user presses an alphanumeric key.\r\n * @param ev The event.\r\n */" + }, + "onloadeddata": { + "comment": "/**\r\n * Occurs when media data is loaded at the current playback position.\r\n * @param ev The event.\r\n */" + }, + "onfocus": { + "comment": "/**\r\n * Fires when the object receives focus.\r\n * @param ev The event.\r\n */" + }, + "ontimeupdate": { + "comment": "/**\r\n * Occurs to indicate the current playback position.\r\n * @param ev The event.\r\n */" + }, + "onselect": { + "comment": "/**\r\n * Fires when the current selection changes.\r\n * @param ev The event.\r\n */" + }, + "onended": { + "comment": "/**\r\n * Occurs when the end of playback is reached.\r\n * @param ev The event\r\n */" + }, + "onabort": { + "comment": "/**\r\n * Fires when the user aborts the download.\r\n * @param ev The event.\r\n */" + }, + "onratechange": { + "comment": "/**\r\n * Occurs when the playback rate is increased or decreased.\r\n * @param ev The event.\r\n */" + }, + "onprogress": { + "comment": "/**\r\n * Occurs to indicate progress while downloading media data.\r\n * @param ev The event.\r\n */" + }, + "ondblclick": { + "comment": "/**\r\n * Fires when the user double-clicks the object.\r\n * @param ev The mouse event.\r\n */" + }, + "oncontextmenu": { + "comment": "/**\r\n * Fires when the user clicks the right mouse button in the client area, opening the context menu.\r\n * @param ev The mouse event.\r\n */" + }, + "onloadedmetadata": { + "comment": "/**\r\n * Occurs when the duration and dimensions of the media have been determined.\r\n * @param ev The event.\r\n */" + }, + "onerror": { + "comment": "/**\r\n * Fires when an error occurs during object loading.\r\n * @param ev The event.\r\n */" + }, + "onplay": { + "comment": "/**\r\n * Occurs when the play method is requested.\r\n * @param ev The event.\r\n */" + }, + "onplaying": { + "comment": "/**\r\n * Occurs when the audio or video has started playing.\r\n * @param ev The event.\r\n */" + }, + "onstalled": { + "comment": "/**\r\n * Occurs when the download has stopped.\r\n * @param ev The event.\r\n */" + }, + "onmousemove": { + "comment": "/**\r\n * Fires when the user moves the mouse over the object.\r\n * @param ev The mouse event.\r\n */" + }, + "onmouseup": { + "comment": "/**\r\n * Fires when the user releases a mouse button while the mouse is over the object.\r\n * @param ev The mouse event.\r\n */" + }, + "onmouseover": { + "comment": "/**\r\n * Fires when the user moves the mouse pointer into the object.\r\n * @param ev The mouse event.\r\n */" + }, + "onsuspend": { + "comment": "/**\r\n * Occurs if the load operation has been intentionally halted.\r\n * @param ev The event.\r\n */" + }, + "onmouseout": { + "comment": "/**\r\n * Fires when the user moves the mouse pointer outside the boundaries of the object.\r\n * @param ev The mouse event.\r\n */" + }, + "onmousewheel": { + "comment": "/**\r\n * Fires when the wheel button is rotated.\r\n * @param ev The mouse event\r\n */" + }, + "onvolumechange": { + "comment": "/**\r\n * Occurs when the volume is changed, or playback is muted or unmuted.\r\n * @param ev The event.\r\n */" + }, + "onchange": { + "comment": "/**\r\n * Fires when the contents of the object or selection have changed.\r\n * @param ev The event.\r\n */" + }, + "oncanplay": { + "comment": "/**\r\n * Occurs when playback is possible, but would require further buffering.\r\n * @param ev The event.\r\n */" + }, + "onloadstart": { + "comment": "/**\r\n * Occurs when Internet Explorer begins looking for media data.\r\n * @param ev The event.\r\n */" + }, + "onemptied": { + "comment": "/**\r\n * Occurs when the media element is reset to its initial state.\r\n * @param ev The event.\r\n */" + } + } + } + } + } + }, "interfaces": { "interface": { "Headers": { @@ -519,93 +667,60 @@ } } }, + "DocumentOrShadowRoot": { + "properties": { + "property": { + "styleSheets": { + "comment": "/**\r\n * Retrieves a collection of styleSheet objects representing the style sheets that correspond to each instance of a link or style object in the document.\r\n */" + } + } + } + }, "Document": { "properties": { "property": { - "onkeydown": { - "comment": "/**\r\n * Fires when the user presses a key.\r\n * @param ev The keyboard event\r\n */" - }, - "onkeyup": { - "comment": "/**\r\n * Fires when the user releases a key.\r\n * @param ev The keyboard event\r\n */" - }, "implementation": { "comment": "/**\r\n * Gets the implementation object of the current document.\r\n */" }, - "onreset": { - "comment": "/**\r\n * Fires when the user resets a form.\r\n * @param ev The event.\r\n */" - }, "scripts": { "comment": "/**\r\n * Retrieves a collection of all script objects in the document.\r\n */" }, - "ondragleave": { - "comment": "/**\r\n * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.\r\n * @param ev The drag event.\r\n */" - }, "charset": { "comment": "/**\r\n * Gets or sets the character set used to encode the object.\r\n */" }, "vlinkColor": { "comment": "/**\r\n * Sets or gets the color of the links that the user has visited.\r\n */" }, - "onseeked": { - "comment": "/**\r\n * Occurs when the seek operation ends.\r\n * @param ev The event.\r\n */" - }, "title": { "comment": "/**\r\n * Contains the title of the document.\r\n */" }, "embeds": { "comment": "/**\r\n * Retrieves a collection of all embed objects in the document.\r\n */" }, - "styleSheets": { - "comment": "/**\r\n * Retrieves a collection of styleSheet objects representing the style sheets that correspond to each instance of a link or style object in the document.\r\n */" - }, - "ondurationchange": { - "comment": "/**\r\n * Occurs when the duration attribute is updated.\r\n * @param ev The event.\r\n */" - }, "all": { "comment": "/**\r\n * Returns a reference to the collection of elements contained by the object.\r\n */" }, "forms": { "comment": "/**\r\n * Retrieves a collection, in source order, of all form objects in the document.\r\n */" }, - "onblur": { - "comment": "/**\r\n * Fires when the object loses the input focus.\r\n * @param ev The focus event.\r\n */" - }, "dir": { "comment": "/**\r\n * Sets or retrieves a value that indicates the reading order of the object.\r\n */" }, - "onemptied": { - "comment": "/**\r\n * Occurs when the media element is reset to its initial state.\r\n * @param ev The event.\r\n */" - }, "designMode": { "comment": "/**\r\n * Sets or gets a value that indicates whether the document can be edited.\r\n */" }, - "onseeking": { - "comment": "/**\r\n * Occurs when the current playback position is moved.\r\n * @param ev The event.\r\n */" - }, "ondeactivate": { "comment": "/**\r\n * Fires when the activeElement is changed from the current object to another object in the parent document.\r\n * @param ev The UI Event\r\n */" }, - "oncanplay": { - "comment": "/**\r\n * Occurs when playback is possible, but would require further buffering.\r\n * @param ev The event.\r\n */" - }, - "onloadstart": { - "comment": "/**\r\n * Occurs when Internet Explorer begins looking for media data.\r\n * @param ev The event.\r\n */" - }, "URLUnencoded": { "comment": "/**\r\n * Gets the URL for the document, stripped of any character encoding.\r\n */" }, - "ondragenter": { - "comment": "/**\r\n * Fires on the target element when the user drags the object to a valid drop target.\r\n * @param ev The drag event.\r\n */" - }, "inputEncoding": { "comment": "/**\r\n * Returns the character encoding used to create the webpage that is loaded into the document object.\r\n */" }, "activeElement": { "comment": "/**\r\n * Gets the object that has the focus when the parent document has focus.\r\n */" }, - "onchange": { - "comment": "/**\r\n * Fires when the contents of the object or selection have changed.\r\n * @param ev The event.\r\n */" - }, "links": { "comment": "/**\r\n * Retrieves a collection of all a objects that specify the href property and all area objects in the document.\r\n */" }, @@ -618,9 +733,6 @@ "anchors": { "comment": "/**\r\n * Retrieves a collection of all a objects that have a name and/or id property. Objects in this collection are in HTML source order.\r\n */" }, - "onsuspend": { - "comment": "/**\r\n * Occurs if the load operation has been intentionally halted.\r\n * @param ev The event.\r\n */" - }, "rootElement": { "comment": "/**\r\n * Gets the root svg element in the document hierarchy.\r\n */" }, @@ -633,60 +745,21 @@ "alinkColor": { "comment": "/**\r\n * Sets or gets the color of all active links in the document.\r\n */" }, - "onmouseout": { - "comment": "/**\r\n * Fires when the user moves the mouse pointer outside the boundaries of the object.\r\n * @param ev The mouse event.\r\n */" - }, "onmsthumbnailclick": { "comment": "/**\r\n * Occurs when a user clicks a button in a Thumbnail Toolbar of a webpage running in Site Mode.\r\n * @param ev The event.\r\n */" }, - "onmousewheel": { - "comment": "/**\r\n * Fires when the wheel button is rotated.\r\n * @param ev The mouse event\r\n */" - }, - "onvolumechange": { - "comment": "/**\r\n * Occurs when the volume is changed, or playback is muted or unmuted.\r\n * @param ev The event.\r\n */" - }, "xmlVersion": { "comment": "/**\r\n * Gets or sets the version attribute specified in the declaration of an XML document.\r\n */" }, - "ondragend": { - "comment": "/**\r\n * Fires on the source object when the user releases the mouse at the close of a drag operation.\r\n * @param ev The event.\r\n */" - }, "doctype": { "comment": "/**\r\n * Gets an object representing the document type declaration associated with the current document.\r\n */" }, - "ondragover": { - "comment": "/**\r\n * Fires on the target element continuously while the user drags the object over a valid drop target.\r\n * @param ev The event.\r\n */" - }, "bgColor": { "comment": "/**\r\n * Deprecated. Sets or retrieves a value that indicates the background color behind the object.\r\n */" }, - "ondragstart": { - "comment": "/**\r\n * Fires on the source object when the user starts to drag a text selection or selected object.\r\n * @param ev The event.\r\n */" - }, - "onmouseup": { - "comment": "/**\r\n * Fires when the user releases a mouse button while the mouse is over the object.\r\n * @param ev The mouse event.\r\n */" - }, - "ondrag": { - "comment": "/**\r\n * Fires on the source object continuously during a drag operation.\r\n * @param ev The event.\r\n */" - }, - "onmouseover": { - "comment": "/**\r\n * Fires when the user moves the mouse pointer into the object.\r\n * @param ev The mouse event.\r\n */" - }, "linkColor": { "comment": "/**\r\n * Sets or gets the color of the document links.\r\n */" }, - "onpause": { - "comment": "/**\r\n * Occurs when playback is paused.\r\n * @param ev The event.\r\n */" - }, - "onmousedown": { - "comment": "/**\r\n * Fires when the user clicks the object with either mouse button.\r\n * @param ev The mouse event.\r\n */" - }, - "onclick": { - "comment": "/**\r\n * Fires when the user clicks the left mouse button on the object\r\n * @param ev The mouse event.\r\n */" - }, - "onwaiting": { - "comment": "/**\r\n * Occurs when playback stops because the next frame of a video resource is not available.\r\n * @param ev The event.\r\n */" - }, "onstop": { "comment": "/**\r\n * Fires when the user clicks the Stop button or leaves the Web page.\r\n * @param ev The event.\r\n */" }, @@ -702,48 +775,15 @@ "domain": { "comment": "/**\r\n * Sets or gets the security domain of the document.\r\n */" }, - "onstalled": { - "comment": "/**\r\n * Occurs when the download has stopped.\r\n * @param ev The event.\r\n */" - }, - "onmousemove": { - "comment": "/**\r\n * Fires when the user moves the mouse over the object.\r\n * @param ev The mouse event.\r\n */" - }, "documentElement": { "comment": "/**\r\n * Gets a reference to the root node of the document.\r\n */" }, - "onratechange": { - "comment": "/**\r\n * Occurs when the playback rate is increased or decreased.\r\n * @param ev The event.\r\n */" - }, - "onprogress": { - "comment": "/**\r\n * Occurs to indicate progress while downloading media data.\r\n * @param ev The event.\r\n */" - }, - "ondblclick": { - "comment": "/**\r\n * Fires when the user double-clicks the object.\r\n * @param ev The mouse event.\r\n */" - }, - "oncontextmenu": { - "comment": "/**\r\n * Fires when the user clicks the right mouse button in the client area, opening the context menu.\r\n * @param ev The mouse event.\r\n */" - }, - "onloadedmetadata": { - "comment": "/**\r\n * Occurs when the duration and dimensions of the media have been determined.\r\n * @param ev The event.\r\n */" - }, - "onerror": { - "comment": "/**\r\n * Fires when an error occurs during object loading.\r\n * @param ev The event.\r\n */" - }, - "onplay": { - "comment": "/**\r\n * Occurs when the play method is requested.\r\n * @param ev The event.\r\n */" - }, - "onplaying": { - "comment": "/**\r\n * Occurs when the audio or video has started playing.\r\n * @param ev The event.\r\n */" - }, "images": { "comment": "/**\r\n * Retrieves a collection, in source order, of img objects in the document.\r\n */" }, "location": { "comment": "/**\r\n * Contains information about the current URL.\r\n */" }, - "onabort": { - "comment": "/**\r\n * Fires when the user aborts the download.\r\n * @param ev The event.\r\n */" - }, "onselectionchange": { "comment": "/**\r\n * Fires when the selection state of a document changes.\r\n * @param ev The event.\r\n */" }, @@ -753,41 +793,17 @@ "lastModified": { "comment": "/**\r\n * Gets the date that the page was last modified, if the page supplies one.\r\n */" }, - "onkeypress": { - "comment": "/**\r\n * Fires when the user presses an alphanumeric key.\r\n * @param ev The event.\r\n */" - }, - "onloadeddata": { - "comment": "/**\r\n * Occurs when media data is loaded at the current playback position.\r\n * @param ev The event.\r\n */" - }, "onbeforedeactivate": { "comment": "/**\r\n * Fires immediately before the activeElement is changed from the current object to another object in the parent document.\r\n * @param ev The event.\r\n */" }, "onactivate": { "comment": "/**\r\n * Fires when the object is set as the active element.\r\n * @param ev The event.\r\n */" }, - "onfocus": { - "comment": "/**\r\n * Fires when the object receives focus.\r\n * @param ev The event.\r\n */" - }, "fgColor": { "comment": "/**\r\n * Sets or gets the foreground (text) color of the document.\r\n */" }, - "ontimeupdate": { - "comment": "/**\r\n * Occurs to indicate the current playback position.\r\n * @param ev The event.\r\n */" - }, - "onselect": { - "comment": "/**\r\n * Fires when the current selection changes.\r\n * @param ev The event.\r\n */" - }, - "onended": { - "comment": "/**\r\n * Occurs when the end of playback is reached.\r\n * @param ev The event\r\n */" - }, "compatMode": { "comment": "/**\r\n * Gets a value that indicates whether standards-compliant mode is switched on for the object.\r\n */" - }, - "onscroll": { - "comment": "/**\r\n * Fires when the user repositions the scroll box in the scroll bar on the object.\r\n * @param ev The event.\r\n */" - }, - "onload": { - "comment": "/**\r\n * Fires immediately after the browser loads the object.\r\n * @param ev The event.\r\n */" } } }, From cc1c3537c13b5c8edadda61ab425991869d49100 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Thu, 5 Jul 2018 11:58:34 +0100 Subject: [PATCH 04/17] move events to global handlers --- inputfiles/comments.json | 36 +++--------------------------------- 1 file changed, 3 insertions(+), 33 deletions(-) diff --git a/inputfiles/comments.json b/inputfiles/comments.json index 463712dba..63a1f8399 100644 --- a/inputfiles/comments.json +++ b/inputfiles/comments.json @@ -141,6 +141,9 @@ }, "onemptied": { "comment": "/**\r\n * Occurs when the media element is reset to its initial state.\r\n * @param ev The event.\r\n */" + }, + "onselectionchange": { + "comment": "/**\r\n * Fires when the selection state of a document changes.\r\n * @param ev The event.\r\n */" } } } @@ -709,12 +712,6 @@ "designMode": { "comment": "/**\r\n * Sets or gets a value that indicates whether the document can be edited.\r\n */" }, - "ondeactivate": { - "comment": "/**\r\n * Fires when the activeElement is changed from the current object to another object in the parent document.\r\n * @param ev The UI Event\r\n */" - }, - "URLUnencoded": { - "comment": "/**\r\n * Gets the URL for the document, stripped of any character encoding.\r\n */" - }, "inputEncoding": { "comment": "/**\r\n * Returns the character encoding used to create the webpage that is loaded into the document object.\r\n */" }, @@ -727,15 +724,9 @@ "URL": { "comment": "/**\r\n * Sets or gets the URL for the current document.\r\n */" }, - "onbeforeactivate": { - "comment": "/**\r\n * Fires immediately before the object is set as the active element.\r\n * @param ev The event.\r\n */" - }, "anchors": { "comment": "/**\r\n * Retrieves a collection of all a objects that have a name and/or id property. Objects in this collection are in HTML source order.\r\n */" }, - "rootElement": { - "comment": "/**\r\n * Gets the root svg element in the document hierarchy.\r\n */" - }, "readyState": { "comment": "/**\r\n * Retrieves a value that indicates the current state of the object.\r\n */" }, @@ -745,12 +736,6 @@ "alinkColor": { "comment": "/**\r\n * Sets or gets the color of all active links in the document.\r\n */" }, - "onmsthumbnailclick": { - "comment": "/**\r\n * Occurs when a user clicks a button in a Thumbnail Toolbar of a webpage running in Site Mode.\r\n * @param ev The event.\r\n */" - }, - "xmlVersion": { - "comment": "/**\r\n * Gets or sets the version attribute specified in the declaration of an XML document.\r\n */" - }, "doctype": { "comment": "/**\r\n * Gets an object representing the document type declaration associated with the current document.\r\n */" }, @@ -760,12 +745,6 @@ "linkColor": { "comment": "/**\r\n * Sets or gets the color of the document links.\r\n */" }, - "onstop": { - "comment": "/**\r\n * Fires when the user clicks the Stop button or leaves the Web page.\r\n * @param ev The event.\r\n */" - }, - "onmssitemodejumplistitemremoved": { - "comment": "/**\r\n * Occurs when an item is removed from a Jump List of a webpage running in Site Mode.\r\n * @param ev The event.\r\n */" - }, "applets": { "comment": "/**\r\n * Retrieves a collection of all applet objects in the document.\r\n */" }, @@ -784,21 +763,12 @@ "location": { "comment": "/**\r\n * Contains information about the current URL.\r\n */" }, - "onselectionchange": { - "comment": "/**\r\n * Fires when the selection state of a document changes.\r\n * @param ev The event.\r\n */" - }, "onreadystatechange": { "comment": "/**\r\n * Fires when the state of the object has changed.\r\n * @param ev The event\r\n */" }, "lastModified": { "comment": "/**\r\n * Gets the date that the page was last modified, if the page supplies one.\r\n */" }, - "onbeforedeactivate": { - "comment": "/**\r\n * Fires immediately before the activeElement is changed from the current object to another object in the parent document.\r\n * @param ev The event.\r\n */" - }, - "onactivate": { - "comment": "/**\r\n * Fires when the object is set as the active element.\r\n * @param ev The event.\r\n */" - }, "fgColor": { "comment": "/**\r\n * Sets or gets the foreground (text) color of the document.\r\n */" }, From 874d815ff432589410702a2870d4052ff1361113 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Thu, 5 Jul 2018 12:09:08 +0100 Subject: [PATCH 05/17] remove removed handlers --- inputfiles/comments.json | 6 ------ 1 file changed, 6 deletions(-) diff --git a/inputfiles/comments.json b/inputfiles/comments.json index 63a1f8399..06469221b 100644 --- a/inputfiles/comments.json +++ b/inputfiles/comments.json @@ -124,9 +124,6 @@ "onmouseout": { "comment": "/**\r\n * Fires when the user moves the mouse pointer outside the boundaries of the object.\r\n * @param ev The mouse event.\r\n */" }, - "onmousewheel": { - "comment": "/**\r\n * Fires when the wheel button is rotated.\r\n * @param ev The mouse event\r\n */" - }, "onvolumechange": { "comment": "/**\r\n * Occurs when the volume is changed, or playback is muted or unmuted.\r\n * @param ev The event.\r\n */" }, @@ -141,9 +138,6 @@ }, "onemptied": { "comment": "/**\r\n * Occurs when the media element is reset to its initial state.\r\n * @param ev The event.\r\n */" - }, - "onselectionchange": { - "comment": "/**\r\n * Fires when the selection state of a document changes.\r\n * @param ev The event.\r\n */" } } } From 0f8015ef7c98cbbb4c384c21b3270903c0798773 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Thu, 5 Jul 2018 12:13:43 +0100 Subject: [PATCH 06/17] update baselines --- src/emitter.ts | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/src/emitter.ts b/src/emitter.ts index 797171d69..19a6d1701 100644 --- a/src/emitter.ts +++ b/src/emitter.ts @@ -352,12 +352,16 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { } } - function matchSingleParamMethodSignature(m: Browser.Method, expectedMName: string, expectedMType: string, expectedParamType: string) { + function matchParamMethodSignature(m: Browser.Method, expectedMName: string, expectedMType: string, expectedParamType: string | string[]) { + if (!Array.isArray(expectedParamType)) { + expectedParamType = [expectedParamType]; + } + return expectedMName === m.name && m.signature && m.signature.length === 1 && convertDomTypeToNullableTsType(m.signature[0]) === expectedMType && - m.signature[0].param && m.signature[0].param!.length === 1 && - convertDomTypeToTsType(m.signature[0].param![0]) === expectedParamType; + m.signature[0].param && m.signature[0].param!.length === expectedParamType.length && + expectedParamType.every((pt, idx) => convertDomTypeToTsType(m.signature[0].param![idx]) === pt); } function processInterfaceType(i: Browser.Interface | Browser.Dictionary, name: string) { @@ -366,7 +370,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { /// Emit overloads for the createElement method function emitCreateElementOverloads(m: Browser.Method) { - if (matchSingleParamMethodSignature(m, "createElement", "Element", "string")) { + if (matchParamMethodSignature(m, "createElement", "Element", ["string", "string | ElementCreationOptions"])) { printer.printLine("createElement(tagName: K, options?: ElementCreationOptions): HTMLElementTagNameMap[K];"); printer.printLine("/** @deprecated */"); printer.printLine("createElement(tagName: K, options?: ElementCreationOptions): HTMLElementDeprecatedTagNameMap[K];"); @@ -376,7 +380,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { /// Emit overloads for the getElementsByTagName method function emitGetElementsByTagNameOverloads(m: Browser.Method) { - if (matchSingleParamMethodSignature(m, "getElementsByTagName", "NodeList", "string")) { + if (matchParamMethodSignature(m, "getElementsByTagName", "NodeList", "string")) { printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: K): NodeListOf;`); printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: K): NodeListOf;`); printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: string): NodeListOf;`); @@ -385,7 +389,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { /// Emit overloads for the querySelector method function emitQuerySelectorOverloads(m: Browser.Method) { - if (matchSingleParamMethodSignature(m, "querySelector", "Element | null", "string")) { + if (matchParamMethodSignature(m, "querySelector", "Element | null", "string")) { printer.printLine("querySelector(selectors: K): HTMLElementTagNameMap[K] | null;"); printer.printLine("querySelector(selectors: K): SVGElementTagNameMap[K] | null;"); printer.printLine("querySelector(selectors: string): E | null;"); @@ -394,7 +398,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { /// Emit overloads for the querySelectorAll method function emitQuerySelectorAllOverloads(m: Browser.Method) { - if (matchSingleParamMethodSignature(m, "querySelectorAll", "NodeList", "string")) { + if (matchParamMethodSignature(m, "querySelectorAll", "NodeList", "string")) { printer.printLine("querySelectorAll(selectors: K): NodeListOf;"); printer.printLine("querySelectorAll(selectors: K): NodeListOf;"); printer.printLine("querySelectorAll(selectors: string): NodeListOf;"); @@ -447,7 +451,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { /// Emit overloads for the createEvent method function emitCreateEventOverloads(m: Browser.Method) { - if (matchSingleParamMethodSignature(m, "createEvent", "Event", "string")) { + if (matchParamMethodSignature(m, "createEvent", "Event", "string")) { // Emit plurals. For example, "Events", "MutationEvents" const hasPlurals = ["Event", "MutationEvent", "MouseEvent", "SVGZoomEvent", "UIEvent"]; for (const x of distinctETypeList) { From 49e2bf0db0154cb5fae20510155f9bf8a9cb23ab Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Thu, 5 Jul 2018 12:53:46 +0100 Subject: [PATCH 07/17] parenthesise variadic params with multiple types --- src/emitter.ts | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/src/emitter.ts b/src/emitter.ts index 19a6d1701..cb8c10a28 100644 --- a/src/emitter.ts +++ b/src/emitter.ts @@ -469,10 +469,11 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { function paramToString(p: Browser.Param) { const isOptional = !p.variadic && p.optional; const pType = isOptional ? convertDomTypeToTsType(p) : convertDomTypeToNullableTsType(p); + const variadicParams = p.variadic && pType.indexOf('|') !== -1; return (p.variadic ? "..." : "") + adjustParamName(p.name) + (isOptional ? "?: " : ": ") + - pType + + (variadicParams ? "(" : "") + pType + (variadicParams ? ")" : "") + (p.variadic ? "[]" : ""); } return ps.map(paramToString).join(", "); From bc7868f541a5a3113100778680444f1a08ed0785 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Fri, 6 Jul 2018 10:22:15 +0100 Subject: [PATCH 08/17] reintroduce getelementsByTagName overrides --- src/emitter.ts | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/src/emitter.ts b/src/emitter.ts index cb8c10a28..e4b893876 100644 --- a/src/emitter.ts +++ b/src/emitter.ts @@ -380,10 +380,10 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { /// Emit overloads for the getElementsByTagName method function emitGetElementsByTagNameOverloads(m: Browser.Method) { - if (matchParamMethodSignature(m, "getElementsByTagName", "NodeList", "string")) { - printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: K): NodeListOf;`); - printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: K): NodeListOf;`); - printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: string): NodeListOf;`); + if (matchParamMethodSignature(m, "getElementsByTagName", "HTMLCollection", "string")) { + printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: K): HTMLCollectionOf;`); + printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: K): HTMLCollectionOf;`); + printer.printLine(`getElementsByTagName(${m.signature[0].param![0].name}: string): HTMLCollectionOf;`); } } From ce129165c1a3fe48f1f5f6847bc3898530609fb8 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Fri, 6 Jul 2018 10:44:03 +0100 Subject: [PATCH 09/17] account for events which inherit UIEvent --- src/emitter.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/emitter.ts b/src/emitter.ts index e4b893876..0444abd86 100644 --- a/src/emitter.ts +++ b/src/emitter.ts @@ -152,7 +152,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { /// Distinct event type list, used in the "createEvent" function const distinctETypeList = distinct( flatMap(allNonCallbackInterfaces, i => i.events ? i.events.event.map(e => e.type) : []) - .concat(allNonCallbackInterfaces.filter(i => i.extends === "Event" && i.name.endsWith("Event")).map(i => i.name)) + .concat(allNonCallbackInterfaces.filter(i => (i.extends === "Event" || i.extends === "UIEvent") && i.name.endsWith("Event")).map(i => i.name)) ).sort(); /// Interface name to its related eventhandler name list map From ab5655cad4c9433d6228dd577fedfa83e22f1adc Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Fri, 6 Jul 2018 10:49:40 +0100 Subject: [PATCH 10/17] reintroduce clipboard events --- inputfiles/addedTypes.json | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/inputfiles/addedTypes.json b/inputfiles/addedTypes.json index 4519431b5..3b185d662 100644 --- a/inputfiles/addedTypes.json +++ b/inputfiles/addedTypes.json @@ -1,6 +1,24 @@ { "mixins": { "mixin": { + "DocumentAndElementEventHandlers": { + "events": { + "event": [ + { + "name": "copy", + "type": "ClipboardEvent" + }, + { + "name": "cut", + "type": "ClipboardEvent" + }, + { + "name": "paste", + "type": "ClipboardEvent" + } + ] + } + }, "GlobalEventHandlers": { "events": { "event": [ From 1b5d500d89ae0d616e47cb76d7db98380e0b4819 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Fri, 6 Jul 2018 10:54:24 +0100 Subject: [PATCH 11/17] include all *Event inheritance in event type lists --- src/emitter.ts | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/emitter.ts b/src/emitter.ts index 0444abd86..4a422c43c 100644 --- a/src/emitter.ts +++ b/src/emitter.ts @@ -152,7 +152,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { /// Distinct event type list, used in the "createEvent" function const distinctETypeList = distinct( flatMap(allNonCallbackInterfaces, i => i.events ? i.events.event.map(e => e.type) : []) - .concat(allNonCallbackInterfaces.filter(i => (i.extends === "Event" || i.extends === "UIEvent") && i.name.endsWith("Event")).map(i => i.name)) + .concat(allNonCallbackInterfaces.filter(i => i.extends && i.extends.endsWith("Event") && i.name.endsWith("Event")).map(i => i.name)) ).sort(); /// Interface name to its related eventhandler name list map From 835b57900e1b808cc0433964fa13e705e94ba070 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Fri, 6 Jul 2018 11:10:37 +0100 Subject: [PATCH 12/17] reintroduce specific event types --- inputfiles/addedTypes.json | 92 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 92 insertions(+) diff --git a/inputfiles/addedTypes.json b/inputfiles/addedTypes.json index 3b185d662..4d992f22f 100644 --- a/inputfiles/addedTypes.json +++ b/inputfiles/addedTypes.json @@ -25,6 +25,98 @@ { "name": "cancel", "type": "Event" + }, + { + "name": "drag", + "type": "DragEvent" + }, + { + "name": "dragend", + "type": "DragEvent" + }, + { + "name": "dragenter", + "type": "DragEvent" + }, + { + "name": "dragleave", + "type": "DragEvent" + }, + { + "name": "dragover", + "type": "DragEvent" + }, + { + "name": "dragstart", + "type": "DragEvent" + }, + { + "name": "drop", + "type": "DragEvent" + }, + { + "name": "keydown", + "type": "KeyboardEvent" + }, + { + "name": "keypress", + "type": "KeyboardEvent" + }, + { + "name": "keyup", + "type": "KeyboardEvent" + }, + { + "name": "mousedown", + "type": "MouseEvent" + }, + { + "name": "mouseenter", + "type": "MouseEvent" + }, + { + "name": "mouseleave", + "type": "MouseEvent" + }, + { + "name": "mousemove", + "type": "MouseEvent" + }, + { + "name": "mouseout", + "type": "MouseEvent" + }, + { + "name": "mouseover", + "type": "MouseEvent" + }, + { + "name": "mouseup", + "type": "MouseEvent" + }, + { + "name": "scroll", + "type": "UIEvent" + }, + { + "name": "select", + "type": "UIEvent" + }, + { + "name": "wheel", + "type": "WheelEvent" + }, + { + "name": "securitypolicyviolation", + "type": "SecurityPolicyViolationEvent" + }, + { + "name": "dblclick", + "type": "MouseEvent" + }, + { + "name": "contextmenu", + "type": "MouseEvent" } ] } From 987cf1938e2fbb9942a778da35196541b769e85b Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Fri, 6 Jul 2018 11:41:04 +0100 Subject: [PATCH 13/17] revert nodelists to using numeric keys --- inputfiles/overridingTypes.json | 9 --------- 1 file changed, 9 deletions(-) diff --git a/inputfiles/overridingTypes.json b/inputfiles/overridingTypes.json index 7705ee0d7..b0c9892e6 100644 --- a/inputfiles/overridingTypes.json +++ b/inputfiles/overridingTypes.json @@ -1579,15 +1579,6 @@ } ] }, - "NodeList": { - "name": "NodeList", - "iterator": { - "kind": "iterable", - "type": [{ - "override-type": "Node" - }] - } - }, "ServiceWorkerContainer": { "name": "ServiceWorkerContainer", "methods": { From 260bdbdcd279c2e89dc7d9be938ef03abcfa28c2 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Tue, 10 Jul 2018 10:00:16 +0100 Subject: [PATCH 14/17] add abort event --- inputfiles/addedTypes.json | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/inputfiles/addedTypes.json b/inputfiles/addedTypes.json index 4d992f22f..b9b0d8d41 100644 --- a/inputfiles/addedTypes.json +++ b/inputfiles/addedTypes.json @@ -183,6 +183,16 @@ }, "interfaces": { "interface": { + "AbortSignal": { + "events": { + "event": [ + { + "name": "abort", + "type": "ProgressEvent" + } + ] + } + }, "ApplicationCache": { "events": { "event": [ From a1117a31a7a350328e4c5e5d66dcaad21eff36af Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Wed, 11 Jul 2018 08:54:48 +0100 Subject: [PATCH 15/17] regenerate baseline --- baselines/dom.generated.d.ts | 1443 ++++++++++++++++++------- baselines/dom.iterable.generated.d.ts | 3 + baselines/webworker.generated.d.ts | 108 +- 3 files changed, 1155 insertions(+), 399 deletions(-) diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index bddde1cbe..d6f09d5b7 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -469,6 +469,10 @@ interface GetNotificationOptions { tag?: string; } +interface GetRootNodeOptions { + composed?: boolean; +} + interface HashChangeEventInit extends EventInit { newURL?: string; oldURL?: string; @@ -722,15 +726,6 @@ interface MouseEventInit extends EventModifierInit { screenY?: number; } -interface MsZoomToOptions { - animate?: string; - contentX?: number; - contentY?: number; - scaleFactor?: number; - viewportX?: string | null; - viewportY?: string | null; -} - interface MutationObserverInit { attributeFilter?: string[]; attributeOldValue?: boolean; @@ -1587,7 +1582,14 @@ declare var ANGLE_instanced_arrays: { }; interface AbortController { + /** + * Returns the AbortSignal object associated with this object. + */ readonly signal: AbortSignal; + /** + * Invoking this method will set this object's AbortSignal's aborted flag and + * signal to any observers that the associated activity is to be aborted. + */ abort(): void; } @@ -1601,6 +1603,10 @@ interface AbortSignalEventMap { } interface AbortSignal extends EventTarget { + /** + * Returns true if this AbortSignal's AbortController has signaled to abort, and false + * otherwise. + */ readonly aborted: boolean; onabort: ((this: AbortSignal, ev: ProgressEvent) => any) | null; addEventListener(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; @@ -1614,6 +1620,19 @@ declare var AbortSignal: { new(): AbortSignal; }; +interface AbstractRange { + readonly collapsed: boolean; + readonly endContainer: Node; + readonly endOffset: number; + readonly startContainer: Node; + readonly startOffset: number; +} + +declare var AbstractRange: { + prototype: AbstractRange; + new(): AbstractRange; +}; + interface AbstractWorkerEventMap { "error": ErrorEvent; } @@ -1792,7 +1811,9 @@ declare var ApplicationCache: { }; interface Attr extends Node { + readonly localName: string; readonly name: string; + readonly namespaceURI: string | null; readonly ownerElement: Element | null; readonly prefix: string | null; readonly specified: boolean; @@ -3014,13 +3035,13 @@ declare var ChannelSplitterNode: { new(context: BaseAudioContext, options?: ChannelSplitterOptions): ChannelSplitterNode; }; -interface CharacterData extends Node, ChildNode { +interface CharacterData extends Node, NonDocumentTypeChildNode, ChildNode { data: string; readonly length: number; - appendData(arg: string): void; + appendData(data: string): void; deleteData(offset: number, count: number): void; - insertData(offset: number, arg: string): void; - replaceData(offset: number, count: number, arg: string): void; + insertData(offset: number, data: string): void; + replaceData(offset: number, count: number, data: string): void; substringData(offset: number, count: number): string; } @@ -3030,7 +3051,28 @@ declare var CharacterData: { }; interface ChildNode { + /** + * Inserts nodes just after node, while replacing strings in nodes with equivalent Text nodes. + * Throws a "HierarchyRequestError" DOMException if the constraints of + * the node tree are violated. + */ + after(...nodes: (Node | string)[]): void; + /** + * Inserts nodes just before node, while replacing strings in nodes with equivalent Text nodes. + * Throws a "HierarchyRequestError" DOMException if the constraints of + * the node tree are violated. + */ + before(...nodes: (Node | string)[]): void; + /** + * Removes node. + */ remove(): void; + /** + * Replaces node with nodes, while replacing strings in nodes with equivalent Text nodes. + * Throws a "HierarchyRequestError" DOMException if the constraints of + * the node tree are violated. + */ + replaceWith(...nodes: (Node | string)[]): void; } interface ClientRect { @@ -3086,7 +3128,6 @@ declare var CloseEvent: { }; interface Comment extends CharacterData { - text: string; } declare var Comment: { @@ -3235,6 +3276,10 @@ declare var CustomElementRegistry: { }; interface CustomEvent extends Event { + /** + * Returns any custom data event was created with. + * Typically used for synthetic events. + */ readonly detail: T; initCustomEvent(typeArg: string, canBubbleArg: boolean, cancelableArg: boolean, detailArg: T): void; } @@ -3576,14 +3621,56 @@ declare var DOMStringMap: { }; interface DOMTokenList { + /** + * Returns the number of tokens. + */ readonly length: number; + /** + * Returns the associated set as string. + * Can be set, to change the associated attribute. + */ + value: string; + /** + * Adds all arguments passed, except those already present. + * Throws a "SyntaxError" DOMException if one of the arguments is the empty + * string. + * Throws an "InvalidCharacterError" DOMException if one of the arguments + * contains any ASCII whitespace. + */ add(...tokens: string[]): void; + /** + * Returns true if token is present, and false otherwise. + */ contains(token: string): boolean; + /** + * tokenlist[index] + */ item(index: number): string | null; + /** + * Removes arguments passed, if they are present. + * Throws a "SyntaxError" DOMException if one of the arguments is the empty + * string. + * Throws an "InvalidCharacterError" DOMException if one of the arguments + * contains any ASCII whitespace. + */ remove(...tokens: string[]): void; + /** + * Replaces token with newToken. + * Returns true if token was replaced with newToken, and false otherwise. + * Throws a "SyntaxError" DOMException if one of the arguments is the empty + * string. + * Throws an "InvalidCharacterError" DOMException if one of the arguments + * contains any ASCII whitespace. + */ replace(oldToken: string, newToken: string): void; - toString(): string; + /** + * Returns true if token is in the associated attribute's supported tokens. Returns + * false otherwise. + * Throws a TypeError if the associated attribute has no supported tokens defined. + */ + supports(token: string): boolean; toggle(token: string, force?: boolean): boolean; + forEach(callbackfn: (value: string, key: number, parent: DOMTokenList) => void, thisArg?: any): void; [index: number]: string; } @@ -3800,106 +3887,15 @@ interface DhKeyGenParams extends Algorithm { } interface DocumentEventMap extends GlobalEventHandlersEventMap, DocumentAndElementEventHandlersEventMap { - "abort": UIEvent; - "activate": Event; - "beforeactivate": Event; - "beforedeactivate": Event; - "blur": FocusEvent; - "canplay": Event; - "canplaythrough": Event; - "change": Event; - "click": MouseEvent; - "contextmenu": PointerEvent; - "dblclick": MouseEvent; - "deactivate": Event; - "drag": DragEvent; - "dragend": DragEvent; - "dragenter": DragEvent; - "dragleave": DragEvent; - "dragover": DragEvent; - "dragstart": DragEvent; - "drop": DragEvent; - "durationchange": Event; - "emptied": Event; - "ended": Event; - "error": ErrorEvent; - "focus": FocusEvent; - "fullscreenchange": Event; - "fullscreenerror": Event; - "input": Event; - "invalid": Event; - "keydown": KeyboardEvent; - "keypress": KeyboardEvent; - "keyup": KeyboardEvent; - "load": Event; - "loadeddata": Event; - "loadedmetadata": Event; - "loadstart": Event; - "mousedown": MouseEvent; - "mousemove": MouseEvent; - "mouseout": MouseEvent; - "mouseover": MouseEvent; - "mouseup": MouseEvent; - "mousewheel": WheelEvent; - "MSContentZoom": Event; - "MSGestureChange": Event; - "MSGestureDoubleTap": Event; - "MSGestureEnd": Event; - "MSGestureHold": Event; - "MSGestureStart": Event; - "MSGestureTap": Event; - "MSInertiaStart": Event; - "MSManipulationStateChanged": Event; - "MSPointerCancel": Event; - "MSPointerDown": Event; - "MSPointerEnter": Event; - "MSPointerLeave": Event; - "MSPointerMove": Event; - "MSPointerOut": Event; - "MSPointerOver": Event; - "MSPointerUp": Event; - "mssitemodejumplistitemremoved": Event; - "msthumbnailclick": Event; - "pause": Event; - "play": Event; - "playing": Event; - "pointerlockchange": Event; - "pointerlockerror": Event; - "progress": ProgressEvent; - "ratechange": Event; - "readystatechange": Event; - "reset": Event; - "scroll": UIEvent; - "seeked": Event; - "seeking": Event; - "select": UIEvent; - "selectionchange": Event; - "selectstart": Event; - "stalled": Event; - "stop": Event; - "submit": Event; - "suspend": Event; - "timeupdate": Event; - "touchcancel": TouchEvent; - "touchend": TouchEvent; - "touchmove": TouchEvent; - "touchstart": TouchEvent; + "readystatechange": ProgressEvent; "visibilitychange": Event; - "volumechange": Event; - "waiting": Event; - "webkitfullscreenchange": Event; - "webkitfullscreenerror": Event; } -interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, DocumentAndElementEventHandlers { +interface Document extends Node, NonElementParentNode, DocumentOrShadowRoot, ParentNode, GlobalEventHandlers, DocumentAndElementEventHandlers { /** * Sets or gets the URL for the current document. */ readonly URL: string; - /** - * Gets the URL for the document, stripped of any character encoding. - */ - readonly URLUnencoded: string; /** * Gets the object that has the focus when the parent document has focus. */ @@ -3933,15 +3929,22 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, * Specifies the beginning and end of the document body. */ body: HTMLElement | null; + /** + * Returns document's encoding. + */ readonly characterSet: string; /** * Gets or sets the character set used to encode the object. */ - charset: string; + readonly charset: string; /** * Gets a value that indicates whether standards-compliant mode is switched on for the object. */ readonly compatMode: string; + /** + * Returns document's content type. + */ + readonly contentType: string; /** * Returns the HTTP cookies that apply to the Document. If there are no cookies or * cookies can't be applied to this resource, the empty string will be returned. @@ -3975,11 +3978,15 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, /** * Gets an object representing the document type declaration associated with the current document. */ - readonly doctype: DocumentType; + readonly doctype: DocumentType | null; /** * Gets a reference to the root node of the document. */ - readonly documentElement: HTMLElement; + readonly documentElement: HTMLElement | null; + /** + * Returns document's URL. + */ + readonly documentURI: string; /** * Sets or gets the security domain of the document. */ @@ -3997,8 +4004,6 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, * Retrieves a collection, in source order, of all form objects in the document. */ readonly forms: HTMLCollectionOf; - readonly fullscreenElement: Element | null; - readonly fullscreenEnabled: boolean; /** * Returns the head element. */ @@ -4015,7 +4020,7 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, /** * Returns the character encoding used to create the webpage that is loaded into the document object. */ - readonly inputEncoding: string | null; + readonly inputEncoding: string; /** * Gets the date that the page was last modified, if the page supplies one. */ @@ -4033,88 +4038,20 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, * Contains information about the current URL. */ location: Location | null; - msCSSOMElementFloatMetrics: boolean; - msCapsLockWarningOff: boolean; - /** - * Fires when the object is set as the active element. - * @param ev The event. - */ - onactivate: ((this: Document, ev: Event) => any) | null; - /** - * Fires immediately before the object is set as the active element. - * @param ev The event. - */ - onbeforeactivate: ((this: Document, ev: Event) => any) | null; - /** - * Fires immediately before the activeElement is changed from the current object to another object in the parent document. - * @param ev The event. - */ - onbeforedeactivate: ((this: Document, ev: Event) => any) | null; - /** - * Fires when the activeElement is changed from the current object to another object in the parent document. - * @param ev The UI Event - */ - ondeactivate: ((this: Document, ev: Event) => any) | null; - onfullscreenchange: ((this: Document, ev: Event) => any) | null; - onfullscreenerror: ((this: Document, ev: Event) => any) | null; - /** - * Fires when the wheel button is rotated. - * @param ev The mouse event - */ - onmousewheel: ((this: Document, ev: WheelEvent) => any) | null; - onmscontentzoom: ((this: Document, ev: Event) => any) | null; - onmsgesturechange: ((this: Document, ev: Event) => any) | null; - onmsgesturedoubletap: ((this: Document, ev: Event) => any) | null; - onmsgestureend: ((this: Document, ev: Event) => any) | null; - onmsgesturehold: ((this: Document, ev: Event) => any) | null; - onmsgesturestart: ((this: Document, ev: Event) => any) | null; - onmsgesturetap: ((this: Document, ev: Event) => any) | null; - onmsinertiastart: ((this: Document, ev: Event) => any) | null; - onmsmanipulationstatechanged: ((this: Document, ev: Event) => any) | null; - onmspointercancel: ((this: Document, ev: Event) => any) | null; - onmspointerdown: ((this: Document, ev: Event) => any) | null; - onmspointerenter: ((this: Document, ev: Event) => any) | null; - onmspointerleave: ((this: Document, ev: Event) => any) | null; - onmspointermove: ((this: Document, ev: Event) => any) | null; - onmspointerout: ((this: Document, ev: Event) => any) | null; - onmspointerover: ((this: Document, ev: Event) => any) | null; - onmspointerup: ((this: Document, ev: Event) => any) | null; - /** - * Occurs when an item is removed from a Jump List of a webpage running in Site Mode. - * @param ev The event. - */ - onmssitemodejumplistitemremoved: ((this: Document, ev: Event) => any) | null; - /** - * Occurs when a user clicks a button in a Thumbnail Toolbar of a webpage running in Site Mode. - * @param ev The event. - */ - onmsthumbnailclick: ((this: Document, ev: Event) => any) | null; - onpointerlockchange: ((this: Document, ev: Event) => any) | null; - onpointerlockerror: ((this: Document, ev: Event) => any) | null; /** * Fires when the state of the object has changed. * @param ev The event */ - onreadystatechange: ((this: Document, ev: Event) => any) | null; - /** - * Fires when the selection state of a document changes. - * @param ev The event. - */ - onselectionchange: ((this: Document, ev: Event) => any) | null; - onselectstart: ((this: Document, ev: Event) => any) | null; + onreadystatechange: ((this: Document, ev: ProgressEvent) => any) | null; + onvisibilitychange: ((this: Document, ev: Event) => any) | null; /** - * Fires when the user clicks the Stop button or leaves the Web page. - * @param ev The event. + * Returns document's origin. */ - onstop: ((this: Document, ev: Event) => any) | null; - onvisibilitychange: ((this: Document, ev: Event) => any) | null; - onwebkitfullscreenchange: ((this: Document, ev: Event) => any) | null; - onwebkitfullscreenerror: ((this: Document, ev: Event) => any) | null; + readonly origin: string; /** * Return an HTMLCollection of the embed elements in the Document. */ readonly plugins: HTMLCollectionOf; - readonly pointerLockElement: Element; /** * Retrieves a value that indicates the current state of the object. */ @@ -4123,19 +4060,11 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, * Gets the URL of the location that referred the user to the current page. */ readonly referrer: string; - /** - * Gets the root svg element in the document hierarchy. - */ - readonly rootElement: SVGSVGElement; /** * Retrieves a collection of all script objects in the document. */ readonly scripts: HTMLCollectionOf; readonly scrollingElement: Element | null; - /** - * Retrieves a collection of styleSheet objects representing the style sheets that correspond to each instance of a link or style object in the document. - */ - readonly styleSheets: StyleSheetList; readonly timeline: DocumentTimeline; /** * Contains the title of the document. @@ -4147,21 +4076,15 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, */ /** @deprecated */ vlinkColor: string; - readonly webkitCurrentFullScreenElement: Element | null; - readonly webkitFullscreenElement: Element | null; - readonly webkitFullscreenEnabled: boolean; - readonly webkitIsFullScreen: boolean; - readonly xmlEncoding: string | null; - xmlStandalone: boolean; /** - * Gets or sets the version attribute specified in the declaration of an XML document. + * Moves node from another document and returns it. + * If node is a document, throws a "NotSupportedError" DOMException or, if node is a shadow root, throws a + * "HierarchyRequestError" DOMException. */ - xmlVersion: string | null; adoptNode(source: T): T; /** @deprecated */ captureEvents(): void; caretPositionFromPoint(x: number, y: number): CaretPosition | null; - caretRangeFromPoint(x: number, y: number): Range; /** @deprecated */ clear(): void; /** @@ -4172,8 +4095,11 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, * Creates an attribute object with a specified name. * @param name String that sets the attribute object's name. */ - createAttribute(name: string): Attr; - createAttributeNS(namespaceURI: string | null, qualifiedName: string): Attr; + createAttribute(localName: string): Attr; + createAttributeNS(namespace: string | null, qualifiedName: string): Attr; + /** + * Returns a CDATASection node whose data is data. + */ createCDATASection(data: string): CDATASection; /** * Creates a comment object with the specified data. @@ -4192,6 +4118,20 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, /** @deprecated */ createElement(tagName: K, options?: ElementCreationOptions): HTMLElementDeprecatedTagNameMap[K]; createElement(tagName: string, options?: ElementCreationOptions): HTMLElement; + /** + * Returns an element with namespace namespace. Its namespace prefix will be everything before ":" (U+003E) in qualifiedName or null. Its local name will be everything after + * ":" (U+003E) in qualifiedName or qualifiedName. + * If localName does not match the Name production an + * "InvalidCharacterError" DOMException will be thrown. + * If one of the following conditions is true a "NamespaceError" DOMException will be thrown: + * localName does not match the QName production. + * Namespace prefix is not null and namespace is the empty string. + * Namespace prefix is "xml" and namespace is not the XML namespace. + * qualifiedName or namespace prefix is "xmlns" and namespace is not the XMLNS namespace. + * namespace is the XMLNS namespace and + * neither qualifiedName nor namespace prefix is "xmlns". + * When supplied, options's is can be used to create a customized built-in element. + */ createElementNS(namespaceURI: "http://www.w3.org/1999/xhtml", qualifiedName: string): HTMLElement; createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: "a"): SVGAElement; createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: "circle"): SVGCircleElement; @@ -4256,9 +4196,85 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: "view"): SVGViewElement; createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: string): SVGElement; createElementNS(namespaceURI: string | null, qualifiedName: string, options?: ElementCreationOptions): Element; - createElementNS(namespaceURI: string | null, qualifiedName: string): Element; - createExpression(expression: string, resolver: XPathNSResolver): XPathExpression; - createNSResolver(nodeResolver: Node): XPathNSResolver; + createElementNS(namespace: string | null, qualifiedName: string, options?: string | ElementCreationOptions): Element; + createEvent(eventInterface: "AnimationEvent"): AnimationEvent; + createEvent(eventInterface: "AnimationPlaybackEvent"): AnimationPlaybackEvent; + createEvent(eventInterface: "AudioProcessingEvent"): AudioProcessingEvent; + createEvent(eventInterface: "BeforeUnloadEvent"): BeforeUnloadEvent; + createEvent(eventInterface: "ClipboardEvent"): ClipboardEvent; + createEvent(eventInterface: "CloseEvent"): CloseEvent; + createEvent(eventInterface: "CompositionEvent"): CompositionEvent; + createEvent(eventInterface: "CustomEvent"): CustomEvent; + createEvent(eventInterface: "DeviceLightEvent"): DeviceLightEvent; + createEvent(eventInterface: "DeviceMotionEvent"): DeviceMotionEvent; + createEvent(eventInterface: "DeviceOrientationEvent"): DeviceOrientationEvent; + createEvent(eventInterface: "DragEvent"): DragEvent; + createEvent(eventInterface: "ErrorEvent"): ErrorEvent; + createEvent(eventInterface: "Event"): Event; + createEvent(eventInterface: "Events"): Event; + createEvent(eventInterface: "FocusEvent"): FocusEvent; + createEvent(eventInterface: "FocusNavigationEvent"): FocusNavigationEvent; + createEvent(eventInterface: "GamepadEvent"): GamepadEvent; + createEvent(eventInterface: "HashChangeEvent"): HashChangeEvent; + createEvent(eventInterface: "IDBVersionChangeEvent"): IDBVersionChangeEvent; + createEvent(eventInterface: "KeyboardEvent"): KeyboardEvent; + createEvent(eventInterface: "ListeningStateChangedEvent"): ListeningStateChangedEvent; + createEvent(eventInterface: "MSGestureEvent"): MSGestureEvent; + createEvent(eventInterface: "MSMediaKeyMessageEvent"): MSMediaKeyMessageEvent; + createEvent(eventInterface: "MSMediaKeyNeededEvent"): MSMediaKeyNeededEvent; + createEvent(eventInterface: "MSPointerEvent"): MSPointerEvent; + createEvent(eventInterface: "MediaEncryptedEvent"): MediaEncryptedEvent; + createEvent(eventInterface: "MediaKeyMessageEvent"): MediaKeyMessageEvent; + createEvent(eventInterface: "MediaQueryListEvent"): MediaQueryListEvent; + createEvent(eventInterface: "MediaStreamErrorEvent"): MediaStreamErrorEvent; + createEvent(eventInterface: "MediaStreamEvent"): MediaStreamEvent; + createEvent(eventInterface: "MediaStreamTrackEvent"): MediaStreamTrackEvent; + createEvent(eventInterface: "MessageEvent"): MessageEvent; + createEvent(eventInterface: "MouseEvent"): MouseEvent; + createEvent(eventInterface: "MouseEvents"): MouseEvent; + createEvent(eventInterface: "MutationEvent"): MutationEvent; + createEvent(eventInterface: "MutationEvents"): MutationEvent; + createEvent(eventInterface: "OfflineAudioCompletionEvent"): OfflineAudioCompletionEvent; + createEvent(eventInterface: "OverflowEvent"): OverflowEvent; + createEvent(eventInterface: "PageTransitionEvent"): PageTransitionEvent; + createEvent(eventInterface: "PaymentRequestUpdateEvent"): PaymentRequestUpdateEvent; + createEvent(eventInterface: "PermissionRequestedEvent"): PermissionRequestedEvent; + createEvent(eventInterface: "PointerEvent"): PointerEvent; + createEvent(eventInterface: "PopStateEvent"): PopStateEvent; + createEvent(eventInterface: "ProgressEvent"): ProgressEvent; + createEvent(eventInterface: "PromiseRejectionEvent"): PromiseRejectionEvent; + createEvent(eventInterface: "RTCDTMFToneChangeEvent"): RTCDTMFToneChangeEvent; + createEvent(eventInterface: "RTCDataChannelEvent"): RTCDataChannelEvent; + createEvent(eventInterface: "RTCDtlsTransportStateChangedEvent"): RTCDtlsTransportStateChangedEvent; + createEvent(eventInterface: "RTCErrorEvent"): RTCErrorEvent; + createEvent(eventInterface: "RTCIceCandidatePairChangedEvent"): RTCIceCandidatePairChangedEvent; + createEvent(eventInterface: "RTCIceGathererEvent"): RTCIceGathererEvent; + createEvent(eventInterface: "RTCIceTransportStateChangedEvent"): RTCIceTransportStateChangedEvent; + createEvent(eventInterface: "RTCPeerConnectionIceErrorEvent"): RTCPeerConnectionIceErrorEvent; + createEvent(eventInterface: "RTCPeerConnectionIceEvent"): RTCPeerConnectionIceEvent; + createEvent(eventInterface: "RTCSsrcConflictEvent"): RTCSsrcConflictEvent; + createEvent(eventInterface: "RTCStatsEvent"): RTCStatsEvent; + createEvent(eventInterface: "RTCTrackEvent"): RTCTrackEvent; + createEvent(eventInterface: "SVGZoomEvent"): SVGZoomEvent; + createEvent(eventInterface: "SVGZoomEvents"): SVGZoomEvent; + createEvent(eventInterface: "SecurityPolicyViolationEvent"): SecurityPolicyViolationEvent; + createEvent(eventInterface: "ServiceWorkerMessageEvent"): ServiceWorkerMessageEvent; + createEvent(eventInterface: "SpeechRecognitionError"): SpeechRecognitionError; + createEvent(eventInterface: "SpeechRecognitionEvent"): SpeechRecognitionEvent; + createEvent(eventInterface: "SpeechSynthesisErrorEvent"): SpeechSynthesisErrorEvent; + createEvent(eventInterface: "SpeechSynthesisEvent"): SpeechSynthesisEvent; + createEvent(eventInterface: "StorageEvent"): StorageEvent; + createEvent(eventInterface: "TextEvent"): TextEvent; + createEvent(eventInterface: "TouchEvent"): TouchEvent; + createEvent(eventInterface: "TrackEvent"): TrackEvent; + createEvent(eventInterface: "TransitionEvent"): TransitionEvent; + createEvent(eventInterface: "UIEvent"): UIEvent; + createEvent(eventInterface: "UIEvents"): UIEvent; + createEvent(eventInterface: "VRDisplayEvent"): VRDisplayEvent; + createEvent(eventInterface: "VRDisplayEvent "): VRDisplayEvent ; + createEvent(eventInterface: "WebGLContextEvent"): WebGLContextEvent; + createEvent(eventInterface: "WheelEvent"): WheelEvent; + createEvent(eventInterface: string): Event; /** * Creates a NodeIterator object that you can use to traverse filtered lists of nodes or elements in a document. * @param root The root element or node to start traversing on. @@ -4266,7 +4282,14 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, * @param filter A custom NodeFilter function to use. For more information, see filter. Use null for no filter. * @param entityReferenceExpansion A flag that specifies whether entity reference nodes are expanded. */ - createNodeIterator(root: Node, whatToShow?: number, filter?: NodeFilter, entityReferenceExpansion?: boolean): NodeIterator; + createNodeIterator(root: Node, whatToShow?: number, filter?: NodeFilter | null): NodeIterator; + /** + * Returns a ProcessingInstruction node whose target is target and data is data. + * If target does not match the Name production an + * "InvalidCharacterError" DOMException will be thrown. + * If data contains "?>" an + * "InvalidCharacterError" DOMException will be thrown. + */ createProcessingInstruction(target: string, data: string): ProcessingInstruction; /** * Returns an empty range object that has both of its boundary points positioned at the beginning of the document. @@ -4286,7 +4309,7 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, * @param filter A custom NodeFilter function to use. * @param entityReferenceExpansion A flag that specifies whether entity reference nodes are expanded. */ - createTreeWalker(root: Node, whatToShow?: number, filter?: NodeFilter, entityReferenceExpansion?: boolean): TreeWalker; + createTreeWalker(root: Node, whatToShow?: number, filter?: NodeFilter | null): TreeWalker; /** * Returns the element for the specified x coordinate and the specified y coordinate. * @param x The x-offset @@ -4302,99 +4325,99 @@ interface Document extends Node, GlobalEventHandlers, ParentNode, DocumentEvent, * @param value Value to assign. */ execCommand(commandId: string, showUI?: boolean, value?: string): boolean; - /** - * Displays help information for the given command identifier. - * @param commandId Displays help information for the given command identifier. - */ - execCommandShowHelp(commandId: string): boolean; - exitFullscreen(): void; - exitPointerLock(): void; - /** - * Causes the element to receive the focus and executes the code specified by the onfocus event. - */ - /** @deprecated */ - focus(): void; getAnimations(): Animation[]; /** * Returns a reference to the first object with the specified value of the ID or NAME attribute. * @param elementId String that specifies the ID value. Case-insensitive. */ getElementById(elementId: string): HTMLElement | null; + /** + * collection = element . getElementsByClassName(classNames) + */ getElementsByClassName(classNames: string): HTMLCollectionOf; /** * Gets a collection of objects based on the value of the NAME or ID attribute. * @param elementName Gets a collection of objects based on the value of the NAME or ID attribute. */ getElementsByName(elementName: string): NodeListOf; + /** + * Displays help information for the given command identifier. + * @param commandId Displays help information for the given command identifier. + */ /** * Retrieves a collection of objects based on the specified element name. * @param name Specifies the name of an element. */ - getElementsByTagName(tagname: K): NodeListOf; - getElementsByTagName(tagname: K): NodeListOf; - getElementsByTagName(tagname: string): NodeListOf; - getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf; - getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf; - getElementsByTagNameNS(namespaceURI: string, localName: string): HTMLCollectionOf; + getElementsByTagName(qualifiedName: K): HTMLCollectionOf; + getElementsByTagName(qualifiedName: K): HTMLCollectionOf; + getElementsByTagName(qualifiedName: string): HTMLCollectionOf; /** - * Returns an object representing the current selection of the document that is loaded into the object displaying a webpage. + * Causes the element to receive the focus and executes the code specified by the onfocus event. */ - getSelection(): Selection; /** - * Gets a value indicating whether the object currently has focus. + * Retrieves the string associated with a command. + * @param commandId String that contains the identifier of a command. This can be any command identifier given in the list of Command Identifiers. */ - hasFocus(): boolean; - importNode(importedNode: T, deep: boolean): T; - msElementsFromPoint(x: number, y: number): NodeListOf; - msElementsFromRect(left: number, top: number, width: number, height: number): NodeListOf; /** - * Opens a new window and loads a document specified by a given URL. Also, opens a new window that uses the url parameter and the name parameter to collect the output of the write method and the writeln method. - * @param url Specifies a MIME type for the document. - * @param name Specifies the name of the window. This name is used as the value for the TARGET attribute on a form or an anchor element. - * @param features Contains a list of items separated by commas. Each item consists of an option and a value, separated by an equals sign (for example, "fullscreen=yes, toolbar=yes"). The following values are supported. - * @param replace Specifies whether the existing entry for the document is replaced in the history list. + * Returns the current value of the document, range, or current selection for the given command. + * @param commandId String that specifies a command identifier. */ - open(url?: string, name?: string, features?: string, replace?: boolean): Document; + queryCommandValue(commandId: string): string; /** - * Returns a Boolean value that indicates whether a specified command can be successfully executed using execCommand, given the current state of the document. - * @param commandId Specifies a command identifier. + * Returns an object representing the current selection of the document that is loaded into the object displaying a webpage. */ - queryCommandEnabled(commandId: string): boolean; /** - * Returns a Boolean value that indicates whether the specified command is in the indeterminate state. + * Returns a Boolean value that indicates the current state of the command. * @param commandId String that specifies a command identifier. */ - queryCommandIndeterm(commandId: string): boolean; + queryCommandState(commandId: string): boolean; + /** @deprecated */ + releaseEvents(): void; /** - * Returns a Boolean value that indicates the current state of the command. + * Returns a Boolean value that indicates whether the specified command is in the indeterminate state. * @param commandId String that specifies a command identifier. */ - queryCommandState(commandId: string): boolean; + queryCommandIndeterm(commandId: string): boolean; /** - * Returns a Boolean value that indicates whether the current command is supported on the current range. + * Returns a Boolean value that indicates whether a specified command can be successfully executed using execCommand, given the current state of the document. * @param commandId Specifies a command identifier. */ - queryCommandSupported(commandId: string): boolean; + queryCommandEnabled(commandId: string): boolean; /** - * Retrieves the string associated with a command. - * @param commandId String that contains the identifier of a command. This can be any command identifier given in the list of Command Identifiers. + * Gets a value indicating whether the object currently has focus. */ - queryCommandText(commandId: string): string; + hasFocus(): boolean; /** - * Returns the current value of the document, range, or current selection for the given command. - * @param commandId String that specifies a command identifier. + * Returns a Boolean value that indicates whether the current command is supported on the current range. + * @param commandId Specifies a command identifier. */ - queryCommandValue(commandId: string): string; - /** @deprecated */ - releaseEvents(): void; - updateSettings(): void; - webkitCancelFullScreen(): void; - webkitExitFullscreen(): void; + queryCommandSupported(commandId: string): boolean; + msElementsFromRect(left: number, top: number, width: number, height: number): NodeListOf; + msElementsFromPoint(x: number, y: number): NodeListOf; /** * Writes one or more HTML expressions to a document in the specified window. * @param content Specifies the text and HTML tags to write. */ write(...text: string[]): void; + /** + * If namespace and localName are + * "*" returns a HTMLCollection of all descendant elements. + * If only namespace is "*" returns a HTMLCollection of all descendant elements whose local name is localName. + * If only localName is "*" returns a HTMLCollection of all descendant elements whose namespace is namespace. + * Otherwise, returns a HTMLCollection of all descendant elements whose namespace is namespace and local name is localName. + */ + getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf; + getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf; + getElementsByTagNameNS(namespaceURI: string, localName: string): HTMLCollectionOf; + /** + * Opens a new window and loads a document specified by a given URL. Also, opens a new window that uses the url parameter and the name parameter to collect the output of the write method and the writeln method. + * @param url Specifies a MIME type for the document. + * @param name Specifies the name of the window. This name is used as the value for the TARGET attribute on a form or an anchor element. + * @param features Contains a list of items separated by commas. Each item consists of an option and a value, separated by an equals sign (for example, "fullscreen=yes, toolbar=yes"). The following values are supported. + * @param replace Specifies whether the existing entry for the document is replaced in the history list. + */ + open(url?: string, name?: string, features?: string, replace?: boolean): Document; + importNode(importedNode: T, deep: boolean): T; /** * Writes one or more HTML expressions, followed by a carriage return, to a document in the specified window. * @param content The text and HTML tags to write. @@ -4450,8 +4473,10 @@ interface DocumentEvent { createEvent(eventInterface: "IDBVersionChangeEvent"): IDBVersionChangeEvent; createEvent(eventInterface: "KeyboardEvent"): KeyboardEvent; createEvent(eventInterface: "ListeningStateChangedEvent"): ListeningStateChangedEvent; + createEvent(eventInterface: "MSGestureEvent"): MSGestureEvent; createEvent(eventInterface: "MSMediaKeyMessageEvent"): MSMediaKeyMessageEvent; createEvent(eventInterface: "MSMediaKeyNeededEvent"): MSMediaKeyNeededEvent; + createEvent(eventInterface: "MSPointerEvent"): MSPointerEvent; createEvent(eventInterface: "MediaEncryptedEvent"): MediaEncryptedEvent; createEvent(eventInterface: "MediaKeyMessageEvent"): MediaKeyMessageEvent; createEvent(eventInterface: "MediaQueryListEvent"): MediaQueryListEvent; @@ -4506,7 +4531,7 @@ interface DocumentEvent { createEvent(eventInterface: string): Event; } -interface DocumentFragment extends Node, ParentNode { +interface DocumentFragment extends Node, NonElementParentNode, ParentNode { getElementById(elementId: string): HTMLElement | null; } @@ -4517,6 +4542,9 @@ declare var DocumentFragment: { interface DocumentOrShadowRoot { readonly activeElement: Element | null; + /** + * Retrieves a collection of styleSheet objects representing the style sheets that correspond to each instance of a link or style object in the document. + */ readonly styleSheets: StyleSheetList; elementFromPoint(x: number, y: number): Element | null; elementsFromPoint(x: number, y: number): Element[]; @@ -4532,10 +4560,7 @@ declare var DocumentTimeline: { }; interface DocumentType extends Node, ChildNode { - readonly entities: NamedNodeMap; - readonly internalSubset: string | null; readonly name: string; - readonly notations: NamedNodeMap; readonly publicId: string; readonly systemId: string; } @@ -4601,116 +4626,123 @@ declare var EXT_texture_filter_anisotropic: { readonly TEXTURE_MAX_ANISOTROPY_EXT: number; }; -interface ElementEventMap extends GlobalEventHandlersEventMap { - "ariarequest": Event; - "command": Event; - "gotpointercapture": PointerEvent; - "lostpointercapture": PointerEvent; - "MSGestureChange": Event; - "MSGestureDoubleTap": Event; - "MSGestureEnd": Event; - "MSGestureHold": Event; - "MSGestureStart": Event; - "MSGestureTap": Event; - "MSGotPointerCapture": Event; - "MSInertiaStart": Event; - "MSLostPointerCapture": Event; - "MSPointerCancel": Event; - "MSPointerDown": Event; - "MSPointerEnter": Event; - "MSPointerLeave": Event; - "MSPointerMove": Event; - "MSPointerOut": Event; - "MSPointerOver": Event; - "MSPointerUp": Event; - "touchcancel": TouchEvent; - "touchend": TouchEvent; - "touchmove": TouchEvent; - "touchstart": TouchEvent; - "webkitfullscreenchange": Event; - "webkitfullscreenerror": Event; -} - -interface Element extends Node, GlobalEventHandlers, ElementTraversal, ParentNode, ChildNode, Animatable { +interface Element extends Node, ParentNode, NonDocumentTypeChildNode, ChildNode, Slotable, Animatable { readonly assignedSlot: HTMLSlotElement | null; readonly attributes: NamedNodeMap; + /** + * Allows for manipulation of element's class content attribute as a + * set of whitespace-separated tokens through a DOMTokenList object. + */ readonly classList: DOMTokenList; + /** + * Returns the value of element's class content attribute. Can be set + * to change it. + */ className: string; readonly clientHeight: number; readonly clientLeft: number; readonly clientTop: number; readonly clientWidth: number; + /** + * Returns the value of element's id content attribute. Can be set to + * change it. + */ id: string; - innerHTML: string; - msContentZoomFactor: number; - readonly msRegionOverflow: string; - onariarequest: ((this: Element, ev: Event) => any) | null; - oncommand: ((this: Element, ev: Event) => any) | null; - onmsgesturechange: ((this: Element, ev: Event) => any) | null; - onmsgesturedoubletap: ((this: Element, ev: Event) => any) | null; - onmsgestureend: ((this: Element, ev: Event) => any) | null; - onmsgesturehold: ((this: Element, ev: Event) => any) | null; - onmsgesturestart: ((this: Element, ev: Event) => any) | null; - onmsgesturetap: ((this: Element, ev: Event) => any) | null; - onmsgotpointercapture: ((this: Element, ev: Event) => any) | null; - onmsinertiastart: ((this: Element, ev: Event) => any) | null; - onmslostpointercapture: ((this: Element, ev: Event) => any) | null; - onmspointercancel: ((this: Element, ev: Event) => any) | null; - onmspointerdown: ((this: Element, ev: Event) => any) | null; - onmspointerenter: ((this: Element, ev: Event) => any) | null; - onmspointerleave: ((this: Element, ev: Event) => any) | null; - onmspointermove: ((this: Element, ev: Event) => any) | null; - onmspointerout: ((this: Element, ev: Event) => any) | null; - onmspointerover: ((this: Element, ev: Event) => any) | null; - onmspointerup: ((this: Element, ev: Event) => any) | null; - onwebkitfullscreenchange: ((this: Element, ev: Event) => any) | null; - onwebkitfullscreenerror: ((this: Element, ev: Event) => any) | null; - outerHTML: string; + /** + * Returns the local name. + */ + readonly localName: string; + /** + * Returns the namespace. + */ + readonly namespaceURI: string | null; + /** + * Returns the namespace prefix. + */ readonly prefix: string | null; readonly scrollHeight: number; scrollLeft: number; scrollTop: number; readonly scrollWidth: number; + /** + * Returns element's shadow root, if any, and if shadow root's mode is "open", and null otherwise. + */ readonly shadowRoot: ShadowRoot | null; + /** + * Returns the value of element's slot content attribute. Can be set to + * change it. + */ slot: string; + /** + * Returns the HTML-uppercased qualified name. + */ readonly tagName: string; + /** + * Creates a shadow root for element and returns it. + */ attachShadow(shadowRootInitDict: ShadowRootInit): ShadowRoot; + /** + * Returns the first (starting at element) inclusive ancestor that matches selectors, and null otherwise. + */ closest(selector: K): HTMLElementTagNameMap[K] | null; closest(selector: K): SVGElementTagNameMap[K] | null; closest(selector: string): Element | null; + /** + * Returns element's first attribute whose qualified name is qualifiedName, and null if there is no such attribute otherwise. + */ getAttribute(qualifiedName: string): string | null; - getAttributeNS(namespaceURI: string, localName: string): string; + /** + * Returns element's attribute whose namespace is namespace and local name is localName, and null if there is + * no such attribute otherwise. + */ + getAttributeNS(namespace: string | null, localName: string): string | null; + /** + * Returns the qualified names of all element's attributes. + * Can contain duplicates. + */ + getAttributeNames(): string[]; getAttributeNode(name: string): Attr | null; getAttributeNodeNS(namespaceURI: string, localName: string): Attr | null; getBoundingClientRect(): ClientRect | DOMRect; getClientRects(): ClientRectList | DOMRectList; getElementsByClassName(classNames: string): NodeListOf; - getElementsByTagName(name: K): NodeListOf; - getElementsByTagName(name: K): NodeListOf; - getElementsByTagName(name: string): NodeListOf; + getElementsByTagName(qualifiedName: K): HTMLCollectionOf; + getElementsByTagName(qualifiedName: K): HTMLCollectionOf; + getElementsByTagName(qualifiedName: string): HTMLCollectionOf; getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf; getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf; getElementsByTagNameNS(namespaceURI: string, localName: string): HTMLCollectionOf; - hasAttribute(name: string): boolean; - hasAttributeNS(namespaceURI: string, localName: string): boolean; + /** + * Returns true if element has an attribute whose qualified name is qualifiedName, and false otherwise. + */ + hasAttribute(qualifiedName: string): boolean; + /** + * Returns true if element has an attribute whose namespace is namespace and local name is localName. + */ + hasAttributeNS(namespace: string | null, localName: string): boolean; + /** + * Returns true if element has attributes, and false otherwise. + */ hasAttributes(): boolean; hasPointerCapture(pointerId: number): boolean; insertAdjacentElement(position: InsertPosition, insertedElement: Element): Element | null; insertAdjacentHTML(where: InsertPosition, html: string): void; insertAdjacentText(where: InsertPosition, text: string): void; + /** + * Returns true if matching selectors against element's root yields element, and false otherwise. + */ matches(selectors: string): boolean; msGetRegionContent(): any; - msGetUntransformedBounds(): ClientRect; - msMatchesSelector(selectors: string): boolean; - msReleasePointerCapture(pointerId: number): void; - msSetPointerCapture(pointerId: number): void; - msZoomTo(args: MsZoomToOptions): void; releasePointerCapture(pointerId: number): void; + /** + * Removes element's first attribute whose qualified name is qualifiedName. + */ removeAttribute(qualifiedName: string): void; - removeAttributeNS(namespaceURI: string, localName: string): void; - removeAttributeNode(oldAttr: Attr): Attr; - requestFullscreen(): void; - requestPointerLock(): void; + /** + * Removes element's attribute whose namespace is namespace and local name is localName. + */ + removeAttributeNS(namespace: string | null, localName: string): void; + removeAttributeNode(attr: Attr): Attr; scroll(options?: ScrollToOptions): void; scroll(x: number, y: number): void; scrollBy(options?: ScrollToOptions): void; @@ -4718,18 +4750,24 @@ interface Element extends Node, GlobalEventHandlers, ElementTraversal, ParentNod scrollIntoView(arg?: boolean | ScrollIntoViewOptions): void; scrollTo(options?: ScrollToOptions): void; scrollTo(x: number, y: number): void; + /** + * Sets the value of element's first attribute whose qualified name is qualifiedName to value. + */ setAttribute(qualifiedName: string, value: string): void; - setAttributeNS(namespaceURI: string, qualifiedName: string, value: string): void; - setAttributeNode(newAttr: Attr): Attr; - setAttributeNodeNS(newAttr: Attr): Attr; + /** + * Sets the value of element's attribute whose namespace is namespace and local name is localName to value. + */ + setAttributeNS(namespace: string | null, qualifiedName: string, value: string): void; + setAttributeNode(attr: Attr): Attr | null; + setAttributeNodeNS(attr: Attr): Attr | null; setPointerCapture(pointerId: number): void; + /** + * If force is not given, "toggles" qualifiedName, removing it if it is + * present and adding it if it is not present. If force is true, adds qualifiedName. If force is false, removes qualifiedName. + * Returns true if qualifiedName is now present, and false otherwise. + */ + toggleAttribute(qualifiedName: string, force?: boolean): boolean; webkitMatchesSelector(selectors: string): boolean; - webkitRequestFullScreen(): void; - webkitRequestFullscreen(): void; - addEventListener(type: K, listener: (this: Element, ev: ElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; - addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; - removeEventListener(type: K, listener: (this: Element, ev: ElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void; - removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void; } declare var Element: { @@ -4747,14 +4785,6 @@ interface ElementCreationOptions { is?: string; } -interface ElementTraversal { - readonly childElementCount: number; - readonly firstElementChild: Element | null; - readonly lastElementChild: Element | null; - readonly nextElementSibling: Element | null; - readonly previousElementSibling: Element | null; -} - interface ErrorEvent extends Event { readonly colno: number; readonly error: any; @@ -4769,22 +4799,56 @@ declare var ErrorEvent: { }; interface Event { + /** + * Returns true or false depending on how event was initialized. True if event goes through its target's ancestors in reverse tree order, and false otherwise. + */ readonly bubbles: boolean; cancelBubble: boolean; readonly cancelable: boolean; + /** + * Returns true or false depending on how event was initialized. True if event invokes listeners past a ShadowRoot node that is the root of its target, and false otherwise. + */ readonly composed: boolean; + /** + * Returns the object whose event listener's callback is currently being + * invoked. + */ readonly currentTarget: EventTarget | null; readonly defaultPrevented: boolean; readonly eventPhase: number; + /** + * Returns true if event was dispatched by the user agent, and + * false otherwise. + */ readonly isTrusted: boolean; returnValue: boolean; + /** + * Returns the object to which event is dispatched (its target). + */ readonly target: EventTarget | null; + /** + * Returns the event's timestamp as the number of milliseconds measured relative to + * the time origin. + */ readonly timeStamp: number; + /** + * Returns the type of event, e.g. + * "click", "hashchange", or + * "submit". + */ readonly type: string; composedPath(): EventTarget[]; initEvent(type: string, bubbles?: boolean, cancelable?: boolean): void; preventDefault(): void; + /** + * Invoking this method prevents event from reaching + * any registered event listeners after the current one finishes running and, when dispatched in a tree, also prevents event from reaching any + * other objects. + */ stopImmediatePropagation(): void; + /** + * When dispatched in a tree, invoking this method prevents event from reaching any objects other than the current object. + */ stopPropagation(): void; readonly AT_TARGET: number; readonly BUBBLING_PHASE: number; @@ -4794,7 +4858,7 @@ interface Event { declare var Event: { prototype: Event; - new(typeArg: string, eventInitDict?: EventInit): Event; + new(type: string, eventInitDict?: EventInit): Event; readonly AT_TARGET: number; readonly BUBBLING_PHASE: number; readonly CAPTURING_PHASE: number; @@ -4828,9 +4892,26 @@ interface EventSourceInit { } interface EventTarget { + /** + * Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched. + * The options argument sets listener-specific options. For compatibility this can be a + * boolean, in which case the method behaves exactly as if the value was specified as options's capture. + * When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET. + * When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in §2.8 Observing event listeners. + * When set to true, options's once indicates that the callback will only be invoked once after which the event listener will + * be removed. + * The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture. + */ addEventListener(type: string, listener: EventListenerOrEventListenerObject | null, options?: boolean | AddEventListenerOptions): void; - dispatchEvent(evt: Event): boolean; - removeEventListener(type: string, listener?: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void; + /** + * Dispatches a synthetic event event to target and returns true + * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. + */ + dispatchEvent(event: Event): boolean; + /** + * Removes the event listener in target's event listener list with the same type, callback, and options. + */ + removeEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void; } declare var EventTarget: { @@ -5061,7 +5142,7 @@ interface GlobalEventHandlersEventMap { "change": Event; "click": MouseEvent; "close": Event; - "contextmenu": PointerEvent; + "contextmenu": MouseEvent; "cuechange": Event; "dblclick": MouseEvent; "drag": DragEvent; @@ -5135,56 +5216,188 @@ interface GlobalEventHandlersEventMap { } interface GlobalEventHandlers { + /** + * Fires when the user aborts the download. + * @param ev The event. + */ onabort: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null; onanimationcancel: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null; onanimationend: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null; onanimationiteration: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null; onanimationstart: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null; onauxclick: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires when the object loses the input focus. + * @param ev The focus event. + */ onblur: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null; oncancel: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when playback is possible, but would require further buffering. + * @param ev The event. + */ oncanplay: ((this: GlobalEventHandlers, ev: Event) => any) | null; oncanplaythrough: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires when the contents of the object or selection have changed. + * @param ev The event. + */ onchange: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires when the user clicks the left mouse button on the object + * @param ev The mouse event. + */ onclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; onclose: ((this: GlobalEventHandlers, ev: Event) => any) | null; - oncontextmenu: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; + /** + * Fires when the user clicks the right mouse button in the client area, opening the context menu. + * @param ev The mouse event. + */ + oncontextmenu: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; oncuechange: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires when the user double-clicks the object. + * @param ev The mouse event. + */ ondblclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; + /** + * Fires on the source object continuously during a drag operation. + * @param ev The event. + */ ondrag: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null; + /** + * Fires on the source object when the user releases the mouse at the close of a drag operation. + * @param ev The event. + */ ondragend: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null; + /** + * Fires on the target element when the user drags the object to a valid drop target. + * @param ev The drag event. + */ ondragenter: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null; ondragexit: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation. + * @param ev The drag event. + */ ondragleave: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null; + /** + * Fires on the target element continuously while the user drags the object over a valid drop target. + * @param ev The event. + */ ondragover: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null; + /** + * Fires on the source object when the user starts to drag a text selection or selected object. + * @param ev The event. + */ ondragstart: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null; ondrop: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null; + /** + * Occurs when the duration attribute is updated. + * @param ev The event. + */ ondurationchange: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when the media element is reset to its initial state. + * @param ev The event. + */ onemptied: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when the end of playback is reached. + * @param ev The event + */ onended: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires when an error occurs during object loading. + * @param ev The event. + */ onerror: ((this: GlobalEventHandlers, ev: ErrorEvent) => any) | null; + /** + * Fires when the object receives focus. + * @param ev The event. + */ onfocus: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null; ongotpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; oninput: ((this: GlobalEventHandlers, ev: Event) => any) | null; oninvalid: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires when the user presses a key. + * @param ev The keyboard event + */ onkeydown: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null; + /** + * Fires when the user presses an alphanumeric key. + * @param ev The event. + */ onkeypress: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null; + /** + * Fires when the user releases a key. + * @param ev The keyboard event + */ onkeyup: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null; + /** + * Fires immediately after the browser loads the object. + * @param ev The event. + */ onload: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when media data is loaded at the current playback position. + * @param ev The event. + */ onloadeddata: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when the duration and dimensions of the media have been determined. + * @param ev The event. + */ onloadedmetadata: ((this: GlobalEventHandlers, ev: Event) => any) | null; onloadend: ((this: GlobalEventHandlers, ev: ProgressEvent) => any) | null; + /** + * Occurs when Internet Explorer begins looking for media data. + * @param ev The event. + */ onloadstart: ((this: GlobalEventHandlers, ev: Event) => any) | null; onlostpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; + /** + * Fires when the user clicks the object with either mouse button. + * @param ev The mouse event. + */ onmousedown: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; onmouseenter: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; onmouseleave: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; + /** + * Fires when the user moves the mouse over the object. + * @param ev The mouse event. + */ onmousemove: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; + /** + * Fires when the user moves the mouse pointer outside the boundaries of the object. + * @param ev The mouse event. + */ onmouseout: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; + /** + * Fires when the user moves the mouse pointer into the object. + * @param ev The mouse event. + */ onmouseover: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; + /** + * Fires when the user releases a mouse button while the mouse is over the object. + * @param ev The mouse event. + */ onmouseup: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; + /** + * Occurs when playback is paused. + * @param ev The event. + */ onpause: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when the play method is requested. + * @param ev The event. + */ onplay: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when the audio or video has started playing. + * @param ev The event. + */ onplaying: ((this: GlobalEventHandlers, ev: Event) => any) | null; onpointercancel: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; onpointerdown: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; @@ -5194,18 +5407,58 @@ interface GlobalEventHandlers { onpointerout: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; onpointerover: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; onpointerup: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; + /** + * Occurs to indicate progress while downloading media data. + * @param ev The event. + */ onprogress: ((this: GlobalEventHandlers, ev: ProgressEvent) => any) | null; + /** + * Occurs when the playback rate is increased or decreased. + * @param ev The event. + */ onratechange: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires when the user resets a form. + * @param ev The event. + */ onreset: ((this: GlobalEventHandlers, ev: Event) => any) | null; onresize: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null; + /** + * Fires when the user repositions the scroll box in the scroll bar on the object. + * @param ev The event. + */ onscroll: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null; onsecuritypolicyviolation: ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any) | null; + /** + * Occurs when the seek operation ends. + * @param ev The event. + */ onseeked: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when the current playback position is moved. + * @param ev The event. + */ onseeking: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Fires when the current selection changes. + * @param ev The event. + */ onselect: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null; + /** + * Occurs when the download has stopped. + * @param ev The event. + */ onstalled: ((this: GlobalEventHandlers, ev: Event) => any) | null; onsubmit: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs if the load operation has been intentionally halted. + * @param ev The event. + */ onsuspend: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs to indicate the current playback position. + * @param ev The event. + */ ontimeupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null; ontoggle: ((this: GlobalEventHandlers, ev: Event) => any) | null; ontouchcancel: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null; @@ -5216,7 +5469,15 @@ interface GlobalEventHandlers { ontransitionend: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null; ontransitionrun: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null; ontransitionstart: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null; + /** + * Occurs when the volume is changed, or playback is muted or unmuted. + * @param ev The event. + */ onvolumechange: ((this: GlobalEventHandlers, ev: Event) => any) | null; + /** + * Occurs when playback stops because the next frame of a video resource is not available. + * @param ev The event. + */ onwaiting: ((this: GlobalEventHandlers, ev: Event) => any) | null; onwheel: ((this: GlobalEventHandlers, ev: WheelEvent) => any) | null; addEventListener(type: K, listener: (this: GlobalEventHandlers, ev: GlobalEventHandlersEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; @@ -5752,7 +6013,7 @@ declare var HTMLDocument: { new(): HTMLDocument; }; -interface HTMLElementEventMap extends ElementEventMap, GlobalEventHandlersEventMap, DocumentAndElementEventHandlersEventMap { +interface HTMLElementEventMap extends GlobalEventHandlersEventMap, DocumentAndElementEventHandlersEventMap { } interface HTMLElement extends Element, GlobalEventHandlers, DocumentAndElementEventHandlers, ElementContentEditable, HTMLOrSVGElement { @@ -9752,7 +10013,40 @@ declare var MutationEvent: { interface MutationObserver { disconnect(): void; - observe(target: Node, options: MutationObserverInit): void; + /** + * Instructs the user agent to observe a given target (a node) and report any mutations based on + * the criteria given by options (an object). + * The options argument allows for setting mutation + * observation options via object members. These are the object members that + * can be used: + * childList + * Set to true if mutations to target's children are to be observed. + * attributes + * Set to true if mutations to target's attributes are to be observed. Can be omitted if attributeOldValue or attributeFilter is + * specified. + * characterData + * Set to true if mutations to target's data are to be observed. Can be omitted if characterDataOldValue is specified. + * subtree + * Set to true if mutations to not just target, but + * also target's descendants are to be + * observed. + * attributeOldValue + * Set to true if attributes is true or omitted + * and target's attribute value before the mutation + * needs to be recorded. + * characterDataOldValue + * Set to true if characterData is set to true or omitted and target's data before the mutation + * needs to be recorded. + * attributeFilter + * Set to a list of attribute local names (without namespace) if not all attribute mutations need to be + * observed and attributes is true + * or omitted. + */ + observe(target: Node, options?: MutationObserverInit): void; + /** + * Empties the record queue and + * returns what was in there. + */ takeRecords(): MutationRecord[]; } @@ -9763,13 +10057,41 @@ declare var MutationObserver: { interface MutationRecord { readonly addedNodes: NodeList; + /** + * Returns the local name of the + * changed attribute, and null otherwise. + */ readonly attributeName: string | null; + /** + * Returns the namespace of the + * changed attribute, and null otherwise. + */ readonly attributeNamespace: string | null; + /** + * Return the previous and next sibling respectively + * of the added or removed nodes, and null otherwise. + */ readonly nextSibling: Node | null; + /** + * The return value depends on type. For + * "attributes", it is the value of the + * changed attribute before the change. + * For "characterData", it is the data of the changed node before the change. For + * "childList", it is null. + */ readonly oldValue: string | null; readonly previousSibling: Node | null; + /** + * Return the nodes added and removed + * respectively. + */ readonly removedNodes: NodeList; readonly target: Node; + /** + * Returns "attributes" if it was an attribute mutation. + * "characterData" if it was a mutation to a CharacterData node. And + * "childList" if it was a mutation to the tree of nodes. + */ readonly type: MutationRecordType; } @@ -9886,33 +10208,103 @@ interface NavigatorUserMedia { } interface Node extends EventTarget { - readonly baseURI: string | null; + /** + * Returns node's node document's document base URL. + */ + readonly baseURI: string; + /** + * Returns the children. + */ readonly childNodes: NodeListOf; + /** + * Returns the first child. + */ readonly firstChild: Node & ChildNode | null; + /** + * Returns true if node is connected and false otherwise. + */ readonly isConnected: boolean; + /** + * Returns the last child. + */ readonly lastChild: Node & ChildNode | null; - readonly localName: string | null; - readonly namespaceURI: string | null; + /** + * Returns the next sibling. + */ readonly nextSibling: Node | null; + /** + * Returns a string appropriate for the type of node, as + * follows: + * Element + * Its HTML-uppercased qualified name. + * Attr + * Its qualified name. + * Text + * "#text". + * CDATASection + * "#cdata-section". + * ProcessingInstruction + * Its target. + * Comment + * "#comment". + * Document + * "#document". + * DocumentType + * Its name. + * DocumentFragment + * "#document-fragment". + */ readonly nodeName: string; readonly nodeType: number; nodeValue: string | null; - readonly ownerDocument: Document; + /** + * Returns the node document. + * Returns null for documents. + */ + readonly ownerDocument: Document | null; + /** + * Returns the parent element. + */ readonly parentElement: Element | null; + /** + * Returns the parent. + */ readonly parentNode: Node & ParentNode | null; + /** + * Returns the previous sibling. + */ readonly previousSibling: Node | null; textContent: string | null; appendChild(newChild: T): T; + /** + * Returns a copy of node. If deep is true, the copy also includes the node's descendants. + */ cloneNode(deep?: boolean): Node; compareDocumentPosition(other: Node): number; - contains(child: Node): boolean; + /** + * Returns true if other is an inclusive descendant of node, and false otherwise. + */ + contains(other: Node | null): boolean; + /** + * Returns node's shadow-including root. + */ + getRootNode(options?: GetRootNodeOptions): Node; + /** + * Returns whether node has children. + */ hasChildNodes(): boolean; insertBefore(newChild: T, refChild: Node | null): T; - isDefaultNamespace(namespaceURI: string | null): boolean; - isEqualNode(arg: Node): boolean; - isSameNode(other: Node): boolean; + isDefaultNamespace(namespace: string | null): boolean; + /** + * Returns whether node and otherNode have the same properties. + */ + isEqualNode(otherNode: Node | null): boolean; + isSameNode(otherNode: Node | null): boolean; lookupNamespaceURI(prefix: string | null): string | null; - lookupPrefix(namespaceURI: string | null): string | null; + lookupPrefix(namespace: string | null): string | null; + /** + * Removes empty exclusive Text nodes and concatenates the data of remaining contiguous exclusive Text nodes into the first of their nodes. + */ normalize(): void; removeChild(oldChild: T): T; replaceChild(newChild: Node, oldChild: T): T; @@ -9983,9 +10375,9 @@ declare var NodeFilter: { }; interface NodeIterator { - /** @deprecated */ - readonly expandEntityReferences: boolean; readonly filter: NodeFilter | null; + readonly pointerBeforeReferenceNode: boolean; + readonly referenceNode: Node; readonly root: Node; readonly whatToShow: number; detach(): void; @@ -9999,8 +10391,14 @@ declare var NodeIterator: { }; interface NodeList { + /** + * Returns the number of nodes in the collection. + */ readonly length: number; - item(index: number): Node; + /** + * element = collection[index] + */ + item(index: number): Node | null; /** * Performs the specified action for each node in an list. * @param callbackfn A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the list. @@ -10036,6 +10434,26 @@ interface NodeSelector { querySelectorAll(selectors: string): NodeListOf; } +interface NonDocumentTypeChildNode { + /** + * Returns the first following sibling that + * is an element, and null otherwise. + */ + readonly nextElementSibling: Element | null; + /** + * Returns the first preceding sibling that + * is an element, and null otherwise. + */ + readonly previousElementSibling: Element | null; +} + +interface NonElementParentNode { + /** + * Returns the first element within node's descendants whose ID is elementId. + */ + getElementById(elementId: string): Element | null; +} + interface NotificationEventMap { "click": Event; "close": Event; @@ -10238,12 +10656,43 @@ declare var PannerNode: { interface ParentNode { readonly childElementCount: number; + /** + * Returns the child elements. + */ readonly children: HTMLCollection; + /** + * Returns the first child that is an element, and null otherwise. + */ readonly firstElementChild: Element | null; + /** + * Returns the last child that is an element, and null otherwise. + */ readonly lastElementChild: Element | null; + /** + * Inserts nodes after the last child of node, while replacing + * strings in nodes with equivalent Text nodes. + * Throws a "HierarchyRequestError" DOMException if the constraints of + * the node tree are violated. + */ + append(...nodes: (Node | string)[]): void; + /** + * Inserts nodes before the first child of node, while + * replacing strings in nodes with equivalent Text nodes. + * Throws a "HierarchyRequestError" DOMException if the constraints of + * the node tree are violated. + */ + prepend(...nodes: (Node | string)[]): void; + /** + * Returns the first element that is a descendant of node that + * matches selectors. + */ querySelector(selectors: K): HTMLElementTagNameMap[K] | null; querySelector(selectors: K): SVGElementTagNameMap[K] | null; querySelector(selectors: string): E | null; + /** + * Returns all element descendants of node that + * match selectors. + */ querySelectorAll(selectors: K): NodeListOf; querySelectorAll(selectors: K): NodeListOf; querySelectorAll(selectors: string): NodeListOf; @@ -11243,25 +11692,31 @@ declare var RandomSource: { new(): RandomSource; }; -interface Range { - readonly collapsed: boolean; +interface Range extends AbstractRange { + /** + * Returns the node, furthest away from + * the document, that is an ancestor of both range's start node and end node. + */ readonly commonAncestorContainer: Node; - readonly endContainer: Node; - readonly endOffset: number; - readonly startContainer: Node; - readonly startOffset: number; cloneContents(): DocumentFragment; cloneRange(): Range; collapse(toStart?: boolean): void; compareBoundaryPoints(how: number, sourceRange: Range): number; - createContextualFragment(fragment: string): DocumentFragment; + /** + * Returns −1 if the point is before the range, 0 if the point is + * in the range, and 1 if the point is after the range. + */ + comparePoint(node: Node, offset: number): number; deleteContents(): void; detach(): void; - expand(Unit: ExpandGranularity): boolean; extractContents(): DocumentFragment; getBoundingClientRect(): ClientRect | DOMRect; getClientRects(): ClientRectList | DOMRectList; insertNode(node: Node): void; + /** + * Returns whether range intersects node. + */ + intersectsNode(node: Node): boolean; isPointInRange(node: Node, offset: number): boolean; selectNode(node: Node): void; selectNodeContents(node: Node): void; @@ -11272,7 +11727,6 @@ interface Range { setStartAfter(node: Node): void; setStartBefore(node: Node): void; surroundContents(newParent: Node): void; - toString(): string; readonly END_TO_END: number; readonly END_TO_START: number; readonly START_TO_END: number; @@ -11659,7 +12113,7 @@ declare var SVGDescElement: { new(): SVGDescElement; }; -interface SVGElementEventMap extends ElementEventMap, GlobalEventHandlersEventMap, DocumentAndElementEventHandlersEventMap { +interface SVGElementEventMap extends GlobalEventHandlersEventMap, DocumentAndElementEventHandlersEventMap { } interface SVGElement extends Element, GlobalEventHandlers, DocumentAndElementEventHandlers, SVGElementInstance, HTMLOrSVGElement { @@ -13564,9 +14018,10 @@ declare var ServiceWorkerRegistration: { new(): ServiceWorkerRegistration; }; -interface ShadowRoot extends DocumentOrShadowRoot, DocumentFragment { +interface ShadowRoot extends DocumentOrShadowRoot, DocumentFragment, DocumentOrShadowRoot { readonly host: Element; innerHTML: string; + readonly mode: ShadowRootMode; } interface ShadowRootInit { @@ -13574,6 +14029,10 @@ interface ShadowRootInit { mode: "open" | "closed"; } +interface Slotable { + readonly assignedSlot: HTMLSlotElement | null; +} + interface SourceBuffer extends EventTarget { appendWindowEnd: number; appendWindowStart: number; @@ -13825,6 +14284,14 @@ declare var SpeechSynthesisVoice: { new(): SpeechSynthesisVoice; }; +interface StaticRange extends AbstractRange { +} + +declare var StaticRange: { + prototype: StaticRange; + new(): StaticRange; +}; + interface StereoPannerNode extends AudioNode { readonly pan: AudioParam; } @@ -13979,9 +14446,15 @@ declare var SyncManager: { new(): SyncManager; }; -interface Text extends CharacterData { +interface Text extends CharacterData, Slotable { readonly assignedSlot: HTMLSlotElement | null; + /** + * Returns the combined data of all direct Text node siblings. + */ readonly wholeText: string; + /** + * Splits data at the given offset and returns the remainder as Text node. + */ splitText(offset: number): Text; } @@ -14279,8 +14752,6 @@ declare var TransitionEvent: { interface TreeWalker { currentNode: Node; - /** @deprecated */ - readonly expandEntityReferences: boolean; readonly filter: NodeFilter | null; readonly root: Node; readonly whatToShow: number; @@ -15693,7 +16164,7 @@ interface WindowEventMap extends GlobalEventHandlersEventMap { "change": Event; "click": MouseEvent; "compassneedscalibration": Event; - "contextmenu": PointerEvent; + "contextmenu": MouseEvent; "dblclick": MouseEvent; "devicelight": DeviceLightEvent; "devicemotion": DeviceMotionEvent; @@ -15728,7 +16199,7 @@ interface WindowEventMap extends GlobalEventHandlersEventMap { "mouseout": MouseEvent; "mouseover": MouseEvent; "mouseup": MouseEvent; - "mousewheel": WheelEvent; + "mousewheel": Event; "MSGestureChange": Event; "MSGestureDoubleTap": Event; "MSGestureEnd": Event; @@ -15795,7 +16266,7 @@ interface Window extends EventTarget, WindowTimers, WindowSessionStorage, Window readonly devicePixelRatio: number; readonly doNotTrack: string; readonly document: Document; - event: Event | undefined; + readonly event: Event | undefined; /** @deprecated */ readonly external: External; readonly frameElement: Element; @@ -15821,7 +16292,7 @@ interface Window extends EventTarget, WindowTimers, WindowSessionStorage, Window ondeviceorientation: ((this: Window, ev: DeviceOrientationEvent) => any) | null; onhashchange: ((this: Window, ev: HashChangeEvent) => any) | null; onmessage: ((this: Window, ev: MessageEvent) => any) | null; - onmousewheel: ((this: Window, ev: WheelEvent) => any) | null; + onmousewheel: ((this: Window, ev: Event) => any) | null; onmsgesturechange: ((this: Window, ev: Event) => any) | null; onmsgesturedoubletap: ((this: Window, ev: Event) => any) | null; onmsgestureend: ((this: Window, ev: Event) => any) | null; @@ -16675,7 +17146,7 @@ declare var ondevicemotion: ((this: Window, ev: DeviceMotionEvent) => any) | nul declare var ondeviceorientation: ((this: Window, ev: DeviceOrientationEvent) => any) | null; declare var onhashchange: ((this: Window, ev: HashChangeEvent) => any) | null; declare var onmessage: ((this: Window, ev: MessageEvent) => any) | null; -declare var onmousewheel: ((this: Window, ev: WheelEvent) => any) | null; +declare var onmousewheel: ((this: Window, ev: Event) => any) | null; declare var onmsgesturechange: ((this: Window, ev: Event) => any) | null; declare var onmsgesturedoubletap: ((this: Window, ev: Event) => any) | null; declare var onmsgestureend: ((this: Window, ev: Event) => any) | null; @@ -16773,60 +17244,196 @@ declare function webkitConvertPointFromNodeToPage(node: Node, pt: WebKitPoint): declare function webkitConvertPointFromPageToNode(node: Node, pt: WebKitPoint): WebKitPoint; declare function webkitRequestAnimationFrame(callback: FrameRequestCallback): number; declare function toString(): string; -declare function dispatchEvent(evt: Event): boolean; +/** + * Dispatches a synthetic event event to target and returns true + * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. + */ +declare function dispatchEvent(event: Event): boolean; declare var sessionStorage: Storage; declare var localStorage: Storage; declare var console: Console; +/** + * Fires when the user aborts the download. + * @param ev The event. + */ declare var onabort: ((this: Window, ev: UIEvent) => any) | null; declare var onanimationcancel: ((this: Window, ev: AnimationEvent) => any) | null; declare var onanimationend: ((this: Window, ev: AnimationEvent) => any) | null; declare var onanimationiteration: ((this: Window, ev: AnimationEvent) => any) | null; declare var onanimationstart: ((this: Window, ev: AnimationEvent) => any) | null; declare var onauxclick: ((this: Window, ev: Event) => any) | null; +/** + * Fires when the object loses the input focus. + * @param ev The focus event. + */ declare var onblur: ((this: Window, ev: FocusEvent) => any) | null; declare var oncancel: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when playback is possible, but would require further buffering. + * @param ev The event. + */ declare var oncanplay: ((this: Window, ev: Event) => any) | null; declare var oncanplaythrough: ((this: Window, ev: Event) => any) | null; +/** + * Fires when the contents of the object or selection have changed. + * @param ev The event. + */ declare var onchange: ((this: Window, ev: Event) => any) | null; +/** + * Fires when the user clicks the left mouse button on the object + * @param ev The mouse event. + */ declare var onclick: ((this: Window, ev: MouseEvent) => any) | null; declare var onclose: ((this: Window, ev: Event) => any) | null; -declare var oncontextmenu: ((this: Window, ev: PointerEvent) => any) | null; +/** + * Fires when the user clicks the right mouse button in the client area, opening the context menu. + * @param ev The mouse event. + */ +declare var oncontextmenu: ((this: Window, ev: MouseEvent) => any) | null; declare var oncuechange: ((this: Window, ev: Event) => any) | null; +/** + * Fires when the user double-clicks the object. + * @param ev The mouse event. + */ declare var ondblclick: ((this: Window, ev: MouseEvent) => any) | null; +/** + * Fires on the source object continuously during a drag operation. + * @param ev The event. + */ declare var ondrag: ((this: Window, ev: DragEvent) => any) | null; +/** + * Fires on the source object when the user releases the mouse at the close of a drag operation. + * @param ev The event. + */ declare var ondragend: ((this: Window, ev: DragEvent) => any) | null; +/** + * Fires on the target element when the user drags the object to a valid drop target. + * @param ev The drag event. + */ declare var ondragenter: ((this: Window, ev: DragEvent) => any) | null; declare var ondragexit: ((this: Window, ev: Event) => any) | null; +/** + * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation. + * @param ev The drag event. + */ declare var ondragleave: ((this: Window, ev: DragEvent) => any) | null; +/** + * Fires on the target element continuously while the user drags the object over a valid drop target. + * @param ev The event. + */ declare var ondragover: ((this: Window, ev: DragEvent) => any) | null; +/** + * Fires on the source object when the user starts to drag a text selection or selected object. + * @param ev The event. + */ declare var ondragstart: ((this: Window, ev: DragEvent) => any) | null; declare var ondrop: ((this: Window, ev: DragEvent) => any) | null; +/** + * Occurs when the duration attribute is updated. + * @param ev The event. + */ declare var ondurationchange: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when the media element is reset to its initial state. + * @param ev The event. + */ declare var onemptied: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when the end of playback is reached. + * @param ev The event + */ declare var onended: ((this: Window, ev: Event) => any) | null; +/** + * Fires when an error occurs during object loading. + * @param ev The event. + */ declare var onerror: ((this: Window, ev: ErrorEvent) => any) | null; +/** + * Fires when the object receives focus. + * @param ev The event. + */ declare var onfocus: ((this: Window, ev: FocusEvent) => any) | null; declare var ongotpointercapture: ((this: Window, ev: PointerEvent) => any) | null; declare var oninput: ((this: Window, ev: Event) => any) | null; declare var oninvalid: ((this: Window, ev: Event) => any) | null; +/** + * Fires when the user presses a key. + * @param ev The keyboard event + */ declare var onkeydown: ((this: Window, ev: KeyboardEvent) => any) | null; +/** + * Fires when the user presses an alphanumeric key. + * @param ev The event. + */ declare var onkeypress: ((this: Window, ev: KeyboardEvent) => any) | null; +/** + * Fires when the user releases a key. + * @param ev The keyboard event + */ declare var onkeyup: ((this: Window, ev: KeyboardEvent) => any) | null; +/** + * Fires immediately after the browser loads the object. + * @param ev The event. + */ declare var onload: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when media data is loaded at the current playback position. + * @param ev The event. + */ declare var onloadeddata: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when the duration and dimensions of the media have been determined. + * @param ev The event. + */ declare var onloadedmetadata: ((this: Window, ev: Event) => any) | null; declare var onloadend: ((this: Window, ev: ProgressEvent) => any) | null; +/** + * Occurs when Internet Explorer begins looking for media data. + * @param ev The event. + */ declare var onloadstart: ((this: Window, ev: Event) => any) | null; declare var onlostpointercapture: ((this: Window, ev: PointerEvent) => any) | null; +/** + * Fires when the user clicks the object with either mouse button. + * @param ev The mouse event. + */ declare var onmousedown: ((this: Window, ev: MouseEvent) => any) | null; declare var onmouseenter: ((this: Window, ev: MouseEvent) => any) | null; declare var onmouseleave: ((this: Window, ev: MouseEvent) => any) | null; +/** + * Fires when the user moves the mouse over the object. + * @param ev The mouse event. + */ declare var onmousemove: ((this: Window, ev: MouseEvent) => any) | null; +/** + * Fires when the user moves the mouse pointer outside the boundaries of the object. + * @param ev The mouse event. + */ declare var onmouseout: ((this: Window, ev: MouseEvent) => any) | null; +/** + * Fires when the user moves the mouse pointer into the object. + * @param ev The mouse event. + */ declare var onmouseover: ((this: Window, ev: MouseEvent) => any) | null; +/** + * Fires when the user releases a mouse button while the mouse is over the object. + * @param ev The mouse event. + */ declare var onmouseup: ((this: Window, ev: MouseEvent) => any) | null; +/** + * Occurs when playback is paused. + * @param ev The event. + */ declare var onpause: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when the play method is requested. + * @param ev The event. + */ declare var onplay: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when the audio or video has started playing. + * @param ev The event. + */ declare var onplaying: ((this: Window, ev: Event) => any) | null; declare var onpointercancel: ((this: Window, ev: PointerEvent) => any) | null; declare var onpointerdown: ((this: Window, ev: PointerEvent) => any) | null; @@ -16836,18 +17443,58 @@ declare var onpointermove: ((this: Window, ev: PointerEvent) => any) | null; declare var onpointerout: ((this: Window, ev: PointerEvent) => any) | null; declare var onpointerover: ((this: Window, ev: PointerEvent) => any) | null; declare var onpointerup: ((this: Window, ev: PointerEvent) => any) | null; +/** + * Occurs to indicate progress while downloading media data. + * @param ev The event. + */ declare var onprogress: ((this: Window, ev: ProgressEvent) => any) | null; +/** + * Occurs when the playback rate is increased or decreased. + * @param ev The event. + */ declare var onratechange: ((this: Window, ev: Event) => any) | null; +/** + * Fires when the user resets a form. + * @param ev The event. + */ declare var onreset: ((this: Window, ev: Event) => any) | null; declare var onresize: ((this: Window, ev: UIEvent) => any) | null; +/** + * Fires when the user repositions the scroll box in the scroll bar on the object. + * @param ev The event. + */ declare var onscroll: ((this: Window, ev: UIEvent) => any) | null; declare var onsecuritypolicyviolation: ((this: Window, ev: SecurityPolicyViolationEvent) => any) | null; +/** + * Occurs when the seek operation ends. + * @param ev The event. + */ declare var onseeked: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when the current playback position is moved. + * @param ev The event. + */ declare var onseeking: ((this: Window, ev: Event) => any) | null; +/** + * Fires when the current selection changes. + * @param ev The event. + */ declare var onselect: ((this: Window, ev: UIEvent) => any) | null; +/** + * Occurs when the download has stopped. + * @param ev The event. + */ declare var onstalled: ((this: Window, ev: Event) => any) | null; declare var onsubmit: ((this: Window, ev: Event) => any) | null; +/** + * Occurs if the load operation has been intentionally halted. + * @param ev The event. + */ declare var onsuspend: ((this: Window, ev: Event) => any) | null; +/** + * Occurs to indicate the current playback position. + * @param ev The event. + */ declare var ontimeupdate: ((this: Window, ev: Event) => any) | null; declare var ontoggle: ((this: Window, ev: Event) => any) | null; declare var ontouchcancel: ((this: Window, ev: TouchEvent) => any) | null; @@ -16858,7 +17505,15 @@ declare var ontransitioncancel: ((this: Window, ev: TransitionEvent) => any) | n declare var ontransitionend: ((this: Window, ev: TransitionEvent) => any) | null; declare var ontransitionrun: ((this: Window, ev: TransitionEvent) => any) | null; declare var ontransitionstart: ((this: Window, ev: TransitionEvent) => any) | null; +/** + * Occurs when the volume is changed, or playback is muted or unmuted. + * @param ev The event. + */ declare var onvolumechange: ((this: Window, ev: Event) => any) | null; +/** + * Occurs when playback stops because the next frame of a video resource is not available. + * @param ev The event. + */ declare var onwaiting: ((this: Window, ev: Event) => any) | null; declare var onwheel: ((this: Window, ev: WheelEvent) => any) | null; declare var indexedDB: IDBFactory; @@ -16941,7 +17596,6 @@ type DisplayCaptureSurfaceType = "monitor" | "window" | "application" | "browser type DistanceModelType = "linear" | "inverse" | "exponential"; type DocumentReadyState = "loading" | "interactive" | "complete"; type EndOfStreamError = "network" | "decode"; -type ExpandGranularity = "character" | "word" | "sentence" | "textedit"; type FillMode = "none" | "forwards" | "backwards" | "both" | "auto"; type GamepadHand = "" | "left" | "right"; type GamepadHapticActuatorType = "vibration"; @@ -17027,6 +17681,7 @@ type ScrollSetting = "" | "up"; type SelectionMode = "select" | "start" | "end" | "preserve"; type ServiceWorkerState = "installing" | "installed" | "activating" | "activated" | "redundant"; type ServiceWorkerUpdateViaCache = "imports" | "all" | "none"; +type ShadowRootMode = "open" | "closed"; type SpeechRecognitionErrorCode = "no-speech" | "aborted" | "audio-capture" | "network" | "not-allowed" | "service-not-allowed" | "bad-grammar" | "language-not-supported"; type SpeechSynthesisErrorCode = "canceled" | "interrupted" | "audio-busy" | "audio-hardware" | "network" | "synthesis-unavailable" | "synthesis-failed" | "language-unavailable" | "voice-unavailable" | "text-too-long" | "invalid-argument"; type TextTrackKind = "subtitles" | "captions" | "descriptions" | "chapters" | "metadata"; diff --git a/baselines/dom.iterable.generated.d.ts b/baselines/dom.iterable.generated.d.ts index 2e0017ac8..c7eaa43f6 100644 --- a/baselines/dom.iterable.generated.d.ts +++ b/baselines/dom.iterable.generated.d.ts @@ -31,6 +31,9 @@ interface DOMStringList { interface DOMTokenList { [Symbol.iterator](): IterableIterator; + entries(): IterableIterator<[number, string]>; + keys(): IterableIterator; + values(): IterableIterator; } interface DataTransferItemList { diff --git a/baselines/webworker.generated.d.ts b/baselines/webworker.generated.d.ts index b644d2328..5945a9dab 100644 --- a/baselines/webworker.generated.d.ts +++ b/baselines/webworker.generated.d.ts @@ -33,6 +33,10 @@ interface CloseEventInit extends EventInit { wasClean?: boolean; } +interface CustomEventInit extends EventInit { + detail?: T; +} + interface DOMMatrix2DInit { a?: number; b?: number; @@ -275,11 +279,32 @@ interface EventListener { (evt: Event): void; } +interface AbortController { + /** + * Returns the AbortSignal object associated with this object. + */ + readonly signal: AbortSignal; + /** + * Invoking this method will set this object's AbortSignal's aborted flag and + * signal to any observers that the associated activity is to be aborted. + */ + abort(): void; +} + +declare var AbortController: { + prototype: AbortController; + new(): AbortController; +}; + interface AbortSignalEventMap { "abort": ProgressEvent; } interface AbortSignal extends EventTarget { + /** + * Returns true if this AbortSignal's AbortController has signaled to abort, and false + * otherwise. + */ readonly aborted: boolean; onabort: ((this: AbortSignal, ev: ProgressEvent) => any) | null; addEventListener(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; @@ -530,6 +555,20 @@ declare var CryptoKey: { new(): CryptoKey; }; +interface CustomEvent extends Event { + /** + * Returns any custom data event was created with. + * Typically used for synthetic events. + */ + readonly detail: T; + initCustomEvent(typeArg: string, canBubbleArg: boolean, cancelableArg: boolean, detailArg: T): void; +} + +declare var CustomEvent: { + prototype: CustomEvent; + new(typeArg: string, eventInitDict?: CustomEventInit): CustomEvent; +}; + interface DOMException { readonly code: number; readonly message: string; @@ -835,22 +874,56 @@ declare var ErrorEvent: { }; interface Event { + /** + * Returns true or false depending on how event was initialized. True if event goes through its target's ancestors in reverse tree order, and false otherwise. + */ readonly bubbles: boolean; cancelBubble: boolean; readonly cancelable: boolean; + /** + * Returns true or false depending on how event was initialized. True if event invokes listeners past a ShadowRoot node that is the root of its target, and false otherwise. + */ readonly composed: boolean; + /** + * Returns the object whose event listener's callback is currently being + * invoked. + */ readonly currentTarget: EventTarget | null; readonly defaultPrevented: boolean; readonly eventPhase: number; + /** + * Returns true if event was dispatched by the user agent, and + * false otherwise. + */ readonly isTrusted: boolean; returnValue: boolean; + /** + * Returns the object to which event is dispatched (its target). + */ readonly target: EventTarget | null; + /** + * Returns the event's timestamp as the number of milliseconds measured relative to + * the time origin. + */ readonly timeStamp: number; + /** + * Returns the type of event, e.g. + * "click", "hashchange", or + * "submit". + */ readonly type: string; composedPath(): EventTarget[]; initEvent(type: string, bubbles?: boolean, cancelable?: boolean): void; preventDefault(): void; + /** + * Invoking this method prevents event from reaching + * any registered event listeners after the current one finishes running and, when dispatched in a tree, also prevents event from reaching any + * other objects. + */ stopImmediatePropagation(): void; + /** + * When dispatched in a tree, invoking this method prevents event from reaching any objects other than the current object. + */ stopPropagation(): void; readonly AT_TARGET: number; readonly BUBBLING_PHASE: number; @@ -860,7 +933,7 @@ interface Event { declare var Event: { prototype: Event; - new(typeArg: string, eventInitDict?: EventInit): Event; + new(type: string, eventInitDict?: EventInit): Event; readonly AT_TARGET: number; readonly BUBBLING_PHASE: number; readonly CAPTURING_PHASE: number; @@ -894,9 +967,26 @@ interface EventSourceInit { } interface EventTarget { + /** + * Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched. + * The options argument sets listener-specific options. For compatibility this can be a + * boolean, in which case the method behaves exactly as if the value was specified as options's capture. + * When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET. + * When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in §2.8 Observing event listeners. + * When set to true, options's once indicates that the callback will only be invoked once after which the event listener will + * be removed. + * The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture. + */ addEventListener(type: string, listener: EventListenerOrEventListenerObject | null, options?: boolean | AddEventListenerOptions): void; - dispatchEvent(evt: Event): boolean; - removeEventListener(type: string, listener?: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void; + /** + * Dispatches a synthetic event event to target and returns true + * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. + */ + dispatchEvent(event: Event): boolean; + /** + * Removes the event listener in target's event listener list with the same type, callback, and options. + */ + removeEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: EventListenerOptions | boolean): void; } declare var EventTarget: { @@ -2658,7 +2748,11 @@ interface PerformanceObserverCallback { declare var onmessage: ((this: DedicatedWorkerGlobalScope, ev: MessageEvent) => any) | null; declare function close(): void; declare function postMessage(message: any, transfer?: any[]): void; -declare function dispatchEvent(evt: Event): boolean; +/** + * Dispatches a synthetic event event to target and returns true + * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. + */ +declare function dispatchEvent(event: Event): boolean; declare var caches: CacheStorage; declare var isSecureContext: boolean; declare var location: WorkerLocation; @@ -2666,7 +2760,11 @@ declare var onerror: ((this: DedicatedWorkerGlobalScope, ev: ErrorEvent) => any) declare var performance: Performance; declare var self: WorkerGlobalScope; declare function msWriteProfilerMark(profilerMarkName: string): void; -declare function dispatchEvent(evt: Event): boolean; +/** + * Dispatches a synthetic event event to target and returns true + * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. + */ +declare function dispatchEvent(event: Event): boolean; declare var indexedDB: IDBFactory; declare var msIndexedDB: IDBFactory; declare var navigator: WorkerNavigator; From 0520e3e5212b0919961d4edbddf1561c11f32465 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Wed, 11 Jul 2018 10:08:17 +0100 Subject: [PATCH 16/17] use indents for comments --- src/emitter.ts | 4 ++-- src/widlprocess.ts | 6 +++--- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/src/emitter.ts b/src/emitter.ts index 4a422c43c..3da5e33d0 100644 --- a/src/emitter.ts +++ b/src/emitter.ts @@ -586,7 +586,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { function emitComments(entity: { comment?: string; deprecated?: 1 }, print: (s: string) => void) { if (entity.comment) { - print(entity.comment); + entity.comment.split('\n').forEach(print); } if (entity.deprecated) { print(`/** @deprecated */`); @@ -1131,7 +1131,7 @@ export function emitWebIDl(webidl: Browser.WebIdl, flavor: Flavor) { methods.forEach((m) => { if (comments && comments[m.name]) { - printer.printLine(comments[m.name]); + comments[m.name].split('\n').forEach(printer.printLine); } printer.printLine(`${m.name}(): ${m.definition};`); }); diff --git a/src/widlprocess.ts b/src/widlprocess.ts index 54aa5951e..da4fdd260 100644 --- a/src/widlprocess.ts +++ b/src/widlprocess.ts @@ -88,9 +88,9 @@ function addComments(obj: any, commentMap: Record, container: st const key = container.toLowerCase() + (member ? "-" + member.toLowerCase() : ""); if (commentMap[key]) { const comments = commentMap[key].split("\n"); - obj["comment"] = "/**\n * "; - obj["comment"] += comments.join("\n * "); - obj["comment"] += "\n */"; + obj["comment"] = "/**\n * "; + obj["comment"] += comments.join("\n * "); + obj["comment"] += "\n */"; } } From cf68da395352383899049afec558d64401fa65f2 Mon Sep 17 00:00:00 2001 From: James Garbutt <43081j@users.noreply.github.com> Date: Wed, 11 Jul 2018 10:08:30 +0100 Subject: [PATCH 17/17] update baseline --- baselines/dom.generated.d.ts | 276 ++++---- baselines/webworker.generated.d.ts | 12 +- inputfiles/comments.json | 1000 ++++++++++++++-------------- 3 files changed, 644 insertions(+), 644 deletions(-) diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index d6f09d5b7..20a6123ea 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -17245,17 +17245,17 @@ declare function webkitConvertPointFromPageToNode(node: Node, pt: WebKitPoint): declare function webkitRequestAnimationFrame(callback: FrameRequestCallback): number; declare function toString(): string; /** - * Dispatches a synthetic event event to target and returns true - * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. - */ + * Dispatches a synthetic event event to target and returns true + * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. + */ declare function dispatchEvent(event: Event): boolean; declare var sessionStorage: Storage; declare var localStorage: Storage; declare var console: Console; /** - * Fires when the user aborts the download. - * @param ev The event. - */ + * Fires when the user aborts the download. + * @param ev The event. + */ declare var onabort: ((this: Window, ev: UIEvent) => any) | null; declare var onanimationcancel: ((this: Window, ev: AnimationEvent) => any) | null; declare var onanimationend: ((this: Window, ev: AnimationEvent) => any) | null; @@ -17263,177 +17263,177 @@ declare var onanimationiteration: ((this: Window, ev: AnimationEvent) => any) | declare var onanimationstart: ((this: Window, ev: AnimationEvent) => any) | null; declare var onauxclick: ((this: Window, ev: Event) => any) | null; /** - * Fires when the object loses the input focus. - * @param ev The focus event. - */ + * Fires when the object loses the input focus. + * @param ev The focus event. + */ declare var onblur: ((this: Window, ev: FocusEvent) => any) | null; declare var oncancel: ((this: Window, ev: Event) => any) | null; /** - * Occurs when playback is possible, but would require further buffering. - * @param ev The event. - */ + * Occurs when playback is possible, but would require further buffering. + * @param ev The event. + */ declare var oncanplay: ((this: Window, ev: Event) => any) | null; declare var oncanplaythrough: ((this: Window, ev: Event) => any) | null; /** - * Fires when the contents of the object or selection have changed. - * @param ev The event. - */ + * Fires when the contents of the object or selection have changed. + * @param ev The event. + */ declare var onchange: ((this: Window, ev: Event) => any) | null; /** - * Fires when the user clicks the left mouse button on the object - * @param ev The mouse event. - */ + * Fires when the user clicks the left mouse button on the object + * @param ev The mouse event. + */ declare var onclick: ((this: Window, ev: MouseEvent) => any) | null; declare var onclose: ((this: Window, ev: Event) => any) | null; /** - * Fires when the user clicks the right mouse button in the client area, opening the context menu. - * @param ev The mouse event. - */ + * Fires when the user clicks the right mouse button in the client area, opening the context menu. + * @param ev The mouse event. + */ declare var oncontextmenu: ((this: Window, ev: MouseEvent) => any) | null; declare var oncuechange: ((this: Window, ev: Event) => any) | null; /** - * Fires when the user double-clicks the object. - * @param ev The mouse event. - */ + * Fires when the user double-clicks the object. + * @param ev The mouse event. + */ declare var ondblclick: ((this: Window, ev: MouseEvent) => any) | null; /** - * Fires on the source object continuously during a drag operation. - * @param ev The event. - */ + * Fires on the source object continuously during a drag operation. + * @param ev The event. + */ declare var ondrag: ((this: Window, ev: DragEvent) => any) | null; /** - * Fires on the source object when the user releases the mouse at the close of a drag operation. - * @param ev The event. - */ + * Fires on the source object when the user releases the mouse at the close of a drag operation. + * @param ev The event. + */ declare var ondragend: ((this: Window, ev: DragEvent) => any) | null; /** - * Fires on the target element when the user drags the object to a valid drop target. - * @param ev The drag event. - */ + * Fires on the target element when the user drags the object to a valid drop target. + * @param ev The drag event. + */ declare var ondragenter: ((this: Window, ev: DragEvent) => any) | null; declare var ondragexit: ((this: Window, ev: Event) => any) | null; /** - * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation. - * @param ev The drag event. - */ + * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation. + * @param ev The drag event. + */ declare var ondragleave: ((this: Window, ev: DragEvent) => any) | null; /** - * Fires on the target element continuously while the user drags the object over a valid drop target. - * @param ev The event. - */ + * Fires on the target element continuously while the user drags the object over a valid drop target. + * @param ev The event. + */ declare var ondragover: ((this: Window, ev: DragEvent) => any) | null; /** - * Fires on the source object when the user starts to drag a text selection or selected object. - * @param ev The event. - */ + * Fires on the source object when the user starts to drag a text selection or selected object. + * @param ev The event. + */ declare var ondragstart: ((this: Window, ev: DragEvent) => any) | null; declare var ondrop: ((this: Window, ev: DragEvent) => any) | null; /** - * Occurs when the duration attribute is updated. - * @param ev The event. - */ + * Occurs when the duration attribute is updated. + * @param ev The event. + */ declare var ondurationchange: ((this: Window, ev: Event) => any) | null; /** - * Occurs when the media element is reset to its initial state. - * @param ev The event. - */ + * Occurs when the media element is reset to its initial state. + * @param ev The event. + */ declare var onemptied: ((this: Window, ev: Event) => any) | null; /** - * Occurs when the end of playback is reached. - * @param ev The event - */ + * Occurs when the end of playback is reached. + * @param ev The event + */ declare var onended: ((this: Window, ev: Event) => any) | null; /** - * Fires when an error occurs during object loading. - * @param ev The event. - */ + * Fires when an error occurs during object loading. + * @param ev The event. + */ declare var onerror: ((this: Window, ev: ErrorEvent) => any) | null; /** - * Fires when the object receives focus. - * @param ev The event. - */ + * Fires when the object receives focus. + * @param ev The event. + */ declare var onfocus: ((this: Window, ev: FocusEvent) => any) | null; declare var ongotpointercapture: ((this: Window, ev: PointerEvent) => any) | null; declare var oninput: ((this: Window, ev: Event) => any) | null; declare var oninvalid: ((this: Window, ev: Event) => any) | null; /** - * Fires when the user presses a key. - * @param ev The keyboard event - */ + * Fires when the user presses a key. + * @param ev The keyboard event + */ declare var onkeydown: ((this: Window, ev: KeyboardEvent) => any) | null; /** - * Fires when the user presses an alphanumeric key. - * @param ev The event. - */ + * Fires when the user presses an alphanumeric key. + * @param ev The event. + */ declare var onkeypress: ((this: Window, ev: KeyboardEvent) => any) | null; /** - * Fires when the user releases a key. - * @param ev The keyboard event - */ + * Fires when the user releases a key. + * @param ev The keyboard event + */ declare var onkeyup: ((this: Window, ev: KeyboardEvent) => any) | null; /** - * Fires immediately after the browser loads the object. - * @param ev The event. - */ + * Fires immediately after the browser loads the object. + * @param ev The event. + */ declare var onload: ((this: Window, ev: Event) => any) | null; /** - * Occurs when media data is loaded at the current playback position. - * @param ev The event. - */ + * Occurs when media data is loaded at the current playback position. + * @param ev The event. + */ declare var onloadeddata: ((this: Window, ev: Event) => any) | null; /** - * Occurs when the duration and dimensions of the media have been determined. - * @param ev The event. - */ + * Occurs when the duration and dimensions of the media have been determined. + * @param ev The event. + */ declare var onloadedmetadata: ((this: Window, ev: Event) => any) | null; declare var onloadend: ((this: Window, ev: ProgressEvent) => any) | null; /** - * Occurs when Internet Explorer begins looking for media data. - * @param ev The event. - */ + * Occurs when Internet Explorer begins looking for media data. + * @param ev The event. + */ declare var onloadstart: ((this: Window, ev: Event) => any) | null; declare var onlostpointercapture: ((this: Window, ev: PointerEvent) => any) | null; /** - * Fires when the user clicks the object with either mouse button. - * @param ev The mouse event. - */ + * Fires when the user clicks the object with either mouse button. + * @param ev The mouse event. + */ declare var onmousedown: ((this: Window, ev: MouseEvent) => any) | null; declare var onmouseenter: ((this: Window, ev: MouseEvent) => any) | null; declare var onmouseleave: ((this: Window, ev: MouseEvent) => any) | null; /** - * Fires when the user moves the mouse over the object. - * @param ev The mouse event. - */ + * Fires when the user moves the mouse over the object. + * @param ev The mouse event. + */ declare var onmousemove: ((this: Window, ev: MouseEvent) => any) | null; /** - * Fires when the user moves the mouse pointer outside the boundaries of the object. - * @param ev The mouse event. - */ + * Fires when the user moves the mouse pointer outside the boundaries of the object. + * @param ev The mouse event. + */ declare var onmouseout: ((this: Window, ev: MouseEvent) => any) | null; /** - * Fires when the user moves the mouse pointer into the object. - * @param ev The mouse event. - */ + * Fires when the user moves the mouse pointer into the object. + * @param ev The mouse event. + */ declare var onmouseover: ((this: Window, ev: MouseEvent) => any) | null; /** - * Fires when the user releases a mouse button while the mouse is over the object. - * @param ev The mouse event. - */ + * Fires when the user releases a mouse button while the mouse is over the object. + * @param ev The mouse event. + */ declare var onmouseup: ((this: Window, ev: MouseEvent) => any) | null; /** - * Occurs when playback is paused. - * @param ev The event. - */ + * Occurs when playback is paused. + * @param ev The event. + */ declare var onpause: ((this: Window, ev: Event) => any) | null; /** - * Occurs when the play method is requested. - * @param ev The event. - */ + * Occurs when the play method is requested. + * @param ev The event. + */ declare var onplay: ((this: Window, ev: Event) => any) | null; /** - * Occurs when the audio or video has started playing. - * @param ev The event. - */ + * Occurs when the audio or video has started playing. + * @param ev The event. + */ declare var onplaying: ((this: Window, ev: Event) => any) | null; declare var onpointercancel: ((this: Window, ev: PointerEvent) => any) | null; declare var onpointerdown: ((this: Window, ev: PointerEvent) => any) | null; @@ -17444,57 +17444,57 @@ declare var onpointerout: ((this: Window, ev: PointerEvent) => any) | null; declare var onpointerover: ((this: Window, ev: PointerEvent) => any) | null; declare var onpointerup: ((this: Window, ev: PointerEvent) => any) | null; /** - * Occurs to indicate progress while downloading media data. - * @param ev The event. - */ + * Occurs to indicate progress while downloading media data. + * @param ev The event. + */ declare var onprogress: ((this: Window, ev: ProgressEvent) => any) | null; /** - * Occurs when the playback rate is increased or decreased. - * @param ev The event. - */ + * Occurs when the playback rate is increased or decreased. + * @param ev The event. + */ declare var onratechange: ((this: Window, ev: Event) => any) | null; /** - * Fires when the user resets a form. - * @param ev The event. - */ + * Fires when the user resets a form. + * @param ev The event. + */ declare var onreset: ((this: Window, ev: Event) => any) | null; declare var onresize: ((this: Window, ev: UIEvent) => any) | null; /** - * Fires when the user repositions the scroll box in the scroll bar on the object. - * @param ev The event. - */ + * Fires when the user repositions the scroll box in the scroll bar on the object. + * @param ev The event. + */ declare var onscroll: ((this: Window, ev: UIEvent) => any) | null; declare var onsecuritypolicyviolation: ((this: Window, ev: SecurityPolicyViolationEvent) => any) | null; /** - * Occurs when the seek operation ends. - * @param ev The event. - */ + * Occurs when the seek operation ends. + * @param ev The event. + */ declare var onseeked: ((this: Window, ev: Event) => any) | null; /** - * Occurs when the current playback position is moved. - * @param ev The event. - */ + * Occurs when the current playback position is moved. + * @param ev The event. + */ declare var onseeking: ((this: Window, ev: Event) => any) | null; /** - * Fires when the current selection changes. - * @param ev The event. - */ + * Fires when the current selection changes. + * @param ev The event. + */ declare var onselect: ((this: Window, ev: UIEvent) => any) | null; /** - * Occurs when the download has stopped. - * @param ev The event. - */ + * Occurs when the download has stopped. + * @param ev The event. + */ declare var onstalled: ((this: Window, ev: Event) => any) | null; declare var onsubmit: ((this: Window, ev: Event) => any) | null; /** - * Occurs if the load operation has been intentionally halted. - * @param ev The event. - */ + * Occurs if the load operation has been intentionally halted. + * @param ev The event. + */ declare var onsuspend: ((this: Window, ev: Event) => any) | null; /** - * Occurs to indicate the current playback position. - * @param ev The event. - */ + * Occurs to indicate the current playback position. + * @param ev The event. + */ declare var ontimeupdate: ((this: Window, ev: Event) => any) | null; declare var ontoggle: ((this: Window, ev: Event) => any) | null; declare var ontouchcancel: ((this: Window, ev: TouchEvent) => any) | null; @@ -17506,14 +17506,14 @@ declare var ontransitionend: ((this: Window, ev: TransitionEvent) => any) | null declare var ontransitionrun: ((this: Window, ev: TransitionEvent) => any) | null; declare var ontransitionstart: ((this: Window, ev: TransitionEvent) => any) | null; /** - * Occurs when the volume is changed, or playback is muted or unmuted. - * @param ev The event. - */ + * Occurs when the volume is changed, or playback is muted or unmuted. + * @param ev The event. + */ declare var onvolumechange: ((this: Window, ev: Event) => any) | null; /** - * Occurs when playback stops because the next frame of a video resource is not available. - * @param ev The event. - */ + * Occurs when playback stops because the next frame of a video resource is not available. + * @param ev The event. + */ declare var onwaiting: ((this: Window, ev: Event) => any) | null; declare var onwheel: ((this: Window, ev: WheelEvent) => any) | null; declare var indexedDB: IDBFactory; diff --git a/baselines/webworker.generated.d.ts b/baselines/webworker.generated.d.ts index 5945a9dab..55ffb06f8 100644 --- a/baselines/webworker.generated.d.ts +++ b/baselines/webworker.generated.d.ts @@ -2749,9 +2749,9 @@ declare var onmessage: ((this: DedicatedWorkerGlobalScope, ev: MessageEvent) => declare function close(): void; declare function postMessage(message: any, transfer?: any[]): void; /** - * Dispatches a synthetic event event to target and returns true - * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. - */ + * Dispatches a synthetic event event to target and returns true + * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. + */ declare function dispatchEvent(event: Event): boolean; declare var caches: CacheStorage; declare var isSecureContext: boolean; @@ -2761,9 +2761,9 @@ declare var performance: Performance; declare var self: WorkerGlobalScope; declare function msWriteProfilerMark(profilerMarkName: string): void; /** - * Dispatches a synthetic event event to target and returns true - * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. - */ + * Dispatches a synthetic event event to target and returns true + * if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise. + */ declare function dispatchEvent(event: Event): boolean; declare var indexedDB: IDBFactory; declare var msIndexedDB: IDBFactory; diff --git a/inputfiles/comments.json b/inputfiles/comments.json index 06469221b..35685c918 100644 --- a/inputfiles/comments.json +++ b/inputfiles/comments.json @@ -5,139 +5,139 @@ "properties": { "property": { "ondragleave": { - "comment": "/**\r\n * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.\r\n * @param ev The drag event.\r\n */" + "comment": "/**\r\n * Fires on the target object when the user moves the mouse out of a valid drop target during a drag operation.\r\n * @param ev The drag event.\r\n */" }, "ondragenter": { - "comment": "/**\r\n * Fires on the target element when the user drags the object to a valid drop target.\r\n * @param ev The drag event.\r\n */" + "comment": "/**\r\n * Fires on the target element when the user drags the object to a valid drop target.\r\n * @param ev The drag event.\r\n */" }, "ondragend": { - "comment": "/**\r\n * Fires on the source object when the user releases the mouse at the close of a drag operation.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires on the source object when the user releases the mouse at the close of a drag operation.\r\n * @param ev The event.\r\n */" }, "ondragover": { - "comment": "/**\r\n * Fires on the target element continuously while the user drags the object over a valid drop target.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires on the target element continuously while the user drags the object over a valid drop target.\r\n * @param ev The event.\r\n */" }, "ondragstart": { - "comment": "/**\r\n * Fires on the source object when the user starts to drag a text selection or selected object.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires on the source object when the user starts to drag a text selection or selected object.\r\n * @param ev The event.\r\n */" }, "ondrag": { - "comment": "/**\r\n * Fires on the source object continuously during a drag operation.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires on the source object continuously during a drag operation.\r\n * @param ev The event.\r\n */" }, "onseeked": { - "comment": "/**\r\n * Occurs when the seek operation ends.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the seek operation ends.\r\n * @param ev The event.\r\n */" }, "onseeking": { - "comment": "/**\r\n * Occurs when the current playback position is moved.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the current playback position is moved.\r\n * @param ev The event.\r\n */" }, "onreset": { - "comment": "/**\r\n * Fires when the user resets a form.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires when the user resets a form.\r\n * @param ev The event.\r\n */" }, "onkeydown": { - "comment": "/**\r\n * Fires when the user presses a key.\r\n * @param ev The keyboard event\r\n */" + "comment": "/**\r\n * Fires when the user presses a key.\r\n * @param ev The keyboard event\r\n */" }, "onkeyup": { - "comment": "/**\r\n * Fires when the user releases a key.\r\n * @param ev The keyboard event\r\n */" + "comment": "/**\r\n * Fires when the user releases a key.\r\n * @param ev The keyboard event\r\n */" }, "ondurationchange": { - "comment": "/**\r\n * Occurs when the duration attribute is updated.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the duration attribute is updated.\r\n * @param ev The event.\r\n */" }, "onblur": { - "comment": "/**\r\n * Fires when the object loses the input focus.\r\n * @param ev The focus event.\r\n */" + "comment": "/**\r\n * Fires when the object loses the input focus.\r\n * @param ev The focus event.\r\n */" }, "onload": { - "comment": "/**\r\n * Fires immediately after the browser loads the object.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires immediately after the browser loads the object.\r\n * @param ev The event.\r\n */" }, "onscroll": { - "comment": "/**\r\n * Fires when the user repositions the scroll box in the scroll bar on the object.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires when the user repositions the scroll box in the scroll bar on the object.\r\n * @param ev The event.\r\n */" }, "onpause": { - "comment": "/**\r\n * Occurs when playback is paused.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when playback is paused.\r\n * @param ev The event.\r\n */" }, "onmousedown": { - "comment": "/**\r\n * Fires when the user clicks the object with either mouse button.\r\n * @param ev The mouse event.\r\n */" + "comment": "/**\r\n * Fires when the user clicks the object with either mouse button.\r\n * @param ev The mouse event.\r\n */" }, "onclick": { - "comment": "/**\r\n * Fires when the user clicks the left mouse button on the object\r\n * @param ev The mouse event.\r\n */" + "comment": "/**\r\n * Fires when the user clicks the left mouse button on the object\r\n * @param ev The mouse event.\r\n */" }, "onwaiting": { - "comment": "/**\r\n * Occurs when playback stops because the next frame of a video resource is not available.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when playback stops because the next frame of a video resource is not available.\r\n * @param ev The event.\r\n */" }, "onkeypress": { - "comment": "/**\r\n * Fires when the user presses an alphanumeric key.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires when the user presses an alphanumeric key.\r\n * @param ev The event.\r\n */" }, "onloadeddata": { - "comment": "/**\r\n * Occurs when media data is loaded at the current playback position.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when media data is loaded at the current playback position.\r\n * @param ev The event.\r\n */" }, "onfocus": { - "comment": "/**\r\n * Fires when the object receives focus.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires when the object receives focus.\r\n * @param ev The event.\r\n */" }, "ontimeupdate": { - "comment": "/**\r\n * Occurs to indicate the current playback position.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs to indicate the current playback position.\r\n * @param ev The event.\r\n */" }, "onselect": { - "comment": "/**\r\n * Fires when the current selection changes.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires when the current selection changes.\r\n * @param ev The event.\r\n */" }, "onended": { - "comment": "/**\r\n * Occurs when the end of playback is reached.\r\n * @param ev The event\r\n */" + "comment": "/**\r\n * Occurs when the end of playback is reached.\r\n * @param ev The event\r\n */" }, "onabort": { - "comment": "/**\r\n * Fires when the user aborts the download.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires when the user aborts the download.\r\n * @param ev The event.\r\n */" }, "onratechange": { - "comment": "/**\r\n * Occurs when the playback rate is increased or decreased.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the playback rate is increased or decreased.\r\n * @param ev The event.\r\n */" }, "onprogress": { - "comment": "/**\r\n * Occurs to indicate progress while downloading media data.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs to indicate progress while downloading media data.\r\n * @param ev The event.\r\n */" }, "ondblclick": { - "comment": "/**\r\n * Fires when the user double-clicks the object.\r\n * @param ev The mouse event.\r\n */" + "comment": "/**\r\n * Fires when the user double-clicks the object.\r\n * @param ev The mouse event.\r\n */" }, "oncontextmenu": { - "comment": "/**\r\n * Fires when the user clicks the right mouse button in the client area, opening the context menu.\r\n * @param ev The mouse event.\r\n */" + "comment": "/**\r\n * Fires when the user clicks the right mouse button in the client area, opening the context menu.\r\n * @param ev The mouse event.\r\n */" }, "onloadedmetadata": { - "comment": "/**\r\n * Occurs when the duration and dimensions of the media have been determined.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the duration and dimensions of the media have been determined.\r\n * @param ev The event.\r\n */" }, "onerror": { - "comment": "/**\r\n * Fires when an error occurs during object loading.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires when an error occurs during object loading.\r\n * @param ev The event.\r\n */" }, "onplay": { - "comment": "/**\r\n * Occurs when the play method is requested.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the play method is requested.\r\n * @param ev The event.\r\n */" }, "onplaying": { - "comment": "/**\r\n * Occurs when the audio or video has started playing.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the audio or video has started playing.\r\n * @param ev The event.\r\n */" }, "onstalled": { - "comment": "/**\r\n * Occurs when the download has stopped.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the download has stopped.\r\n * @param ev The event.\r\n */" }, "onmousemove": { - "comment": "/**\r\n * Fires when the user moves the mouse over the object.\r\n * @param ev The mouse event.\r\n */" + "comment": "/**\r\n * Fires when the user moves the mouse over the object.\r\n * @param ev The mouse event.\r\n */" }, "onmouseup": { - "comment": "/**\r\n * Fires when the user releases a mouse button while the mouse is over the object.\r\n * @param ev The mouse event.\r\n */" + "comment": "/**\r\n * Fires when the user releases a mouse button while the mouse is over the object.\r\n * @param ev The mouse event.\r\n */" }, "onmouseover": { - "comment": "/**\r\n * Fires when the user moves the mouse pointer into the object.\r\n * @param ev The mouse event.\r\n */" + "comment": "/**\r\n * Fires when the user moves the mouse pointer into the object.\r\n * @param ev The mouse event.\r\n */" }, "onsuspend": { - "comment": "/**\r\n * Occurs if the load operation has been intentionally halted.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs if the load operation has been intentionally halted.\r\n * @param ev The event.\r\n */" }, "onmouseout": { - "comment": "/**\r\n * Fires when the user moves the mouse pointer outside the boundaries of the object.\r\n * @param ev The mouse event.\r\n */" + "comment": "/**\r\n * Fires when the user moves the mouse pointer outside the boundaries of the object.\r\n * @param ev The mouse event.\r\n */" }, "onvolumechange": { - "comment": "/**\r\n * Occurs when the volume is changed, or playback is muted or unmuted.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the volume is changed, or playback is muted or unmuted.\r\n * @param ev The event.\r\n */" }, "onchange": { - "comment": "/**\r\n * Fires when the contents of the object or selection have changed.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Fires when the contents of the object or selection have changed.\r\n * @param ev The event.\r\n */" }, "oncanplay": { - "comment": "/**\r\n * Occurs when playback is possible, but would require further buffering.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when playback is possible, but would require further buffering.\r\n * @param ev The event.\r\n */" }, "onloadstart": { - "comment": "/**\r\n * Occurs when Internet Explorer begins looking for media data.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when Internet Explorer begins looking for media data.\r\n * @param ev The event.\r\n */" }, "onemptied": { - "comment": "/**\r\n * Occurs when the media element is reset to its initial state.\r\n * @param ev The event.\r\n */" + "comment": "/**\r\n * Occurs when the media element is reset to its initial state.\r\n * @param ev The event.\r\n */" } } } @@ -150,9 +150,9 @@ "iterator": { "comments": { "comment": { - "entries": "/**\r\n * Returns an iterator allowing to go through all key/value pairs contained in this object.\r\n */", - "keys": "/**\r\n * Returns an iterator allowing to go through all keys of the key/value pairs contained in this object.\r\n */", - "values": "/**\r\n * Returns an iterator allowing to go through all values of the key/value pairs contained in this object.\r\n */" + "entries": "/**\r\n * Returns an iterator allowing to go through all key/value pairs contained in this object.\r\n */", + "keys": "/**\r\n * Returns an iterator allowing to go through all keys of the key/value pairs contained in this object.\r\n */", + "values": "/**\r\n * Returns an iterator allowing to go through all values of the key/value pairs contained in this object.\r\n */" } } } @@ -161,9 +161,9 @@ "iterator": { "comments": { "comment": { - "entries": "/**\r\n * Returns an array of key, value pairs for every entry in the list.\r\n */", - "keys": "/**\r\n * Returns a list of keys in the list.\r\n */", - "values": "/**\r\n * Returns a list of values in the list.\r\n */" + "entries": "/**\r\n * Returns an array of key, value pairs for every entry in the list.\r\n */", + "keys": "/**\r\n * Returns a list of keys in the list.\r\n */", + "values": "/**\r\n * Returns a list of values in the list.\r\n */" } } } @@ -172,16 +172,16 @@ "methods": { "method": { "forEach": { - "comment": "/**\r\n * Performs the specified action for each node in an list.\r\n * @param callbackfn A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the list.\r\n * @param thisArg An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.\r\n */" + "comment": "/**\r\n * Performs the specified action for each node in an list.\r\n * @param callbackfn A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the list.\r\n * @param thisArg An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.\r\n */" } } }, "iterator": { "comments": { "comment": { - "entries": "/**\r\n * Returns an array of key, value pairs for every entry in the list.\r\n */", - "keys": "/**\r\n * Returns an list of keys in the list.\r\n */", - "values": "/**\r\n * Returns an list of values in the list.\r\n */" + "entries": "/**\r\n * Returns an array of key, value pairs for every entry in the list.\r\n */", + "keys": "/**\r\n * Returns an list of keys in the list.\r\n */", + "values": "/**\r\n * Returns an list of values in the list.\r\n */" } } } @@ -190,16 +190,16 @@ "methods": { "method": { "forEach": { - "comment": "/**\r\n * Performs the specified action for each node in an list.\r\n * @param callbackfn A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the list.\r\n * @param thisArg An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.\r\n */" + "comment": "/**\r\n * Performs the specified action for each node in an list.\r\n * @param callbackfn A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the list.\r\n * @param thisArg An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.\r\n */" } } }, "iterator": { "comments": { "comment": { - "entries": "/**\r\n * Returns an array of key, value pairs for every entry in the list.\r\n */", - "keys": "/**\r\n * Returns an list of keys in the list.\r\n */", - "values": "/**\r\n * Returns an list of values in the list.\r\n */" + "entries": "/**\r\n * Returns an array of key, value pairs for every entry in the list.\r\n */", + "keys": "/**\r\n * Returns an list of keys in the list.\r\n */", + "values": "/**\r\n * Returns an list of values in the list.\r\n */" } } } @@ -208,74 +208,74 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "cellSpacing": { - "comment": "/**\r\n * Sets or retrieves the amount of space between cells in a table.\r\n */" + "comment": "/**\r\n * Sets or retrieves the amount of space between cells in a table.\r\n */" }, "tFoot": { - "comment": "/**\r\n * Retrieves the tFoot object of the table.\r\n */" + "comment": "/**\r\n * Retrieves the tFoot object of the table.\r\n */" }, "frame": { - "comment": "/**\r\n * Sets or retrieves the way the border frame around the table is displayed.\r\n */" + "comment": "/**\r\n * Sets or retrieves the way the border frame around the table is displayed.\r\n */" }, "rows": { - "comment": "/**\r\n * Sets or retrieves the number of horizontal rows contained in the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number of horizontal rows contained in the object.\r\n */" }, "rules": { - "comment": "/**\r\n * Sets or retrieves which dividing lines (inner borders) are displayed.\r\n */" + "comment": "/**\r\n * Sets or retrieves which dividing lines (inner borders) are displayed.\r\n */" }, "summary": { - "comment": "/**\r\n * Sets or retrieves a description and/or structure of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a description and/or structure of the object.\r\n */" }, "caption": { - "comment": "/**\r\n * Retrieves the caption object of a table.\r\n */" + "comment": "/**\r\n * Retrieves the caption object of a table.\r\n */" }, "tBodies": { - "comment": "/**\r\n * Retrieves a collection of all tBody objects in the table. Objects in this collection are in source order.\r\n */" + "comment": "/**\r\n * Retrieves a collection of all tBody objects in the table. Objects in this collection are in source order.\r\n */" }, "tHead": { - "comment": "/**\r\n * Retrieves the tHead object of the table.\r\n */" + "comment": "/**\r\n * Retrieves the tHead object of the table.\r\n */" }, "align": { - "comment": "/**\r\n * Sets or retrieves a value that indicates the table alignment.\r\n */" + "comment": "/**\r\n * Sets or retrieves a value that indicates the table alignment.\r\n */" }, "cellPadding": { - "comment": "/**\r\n * Sets or retrieves the amount of space between the border of the cell and the content of the cell.\r\n */" + "comment": "/**\r\n * Sets or retrieves the amount of space between the border of the cell and the content of the cell.\r\n */" }, "border": { - "comment": "/**\r\n * Sets or retrieves the width of the border to draw around the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the border to draw around the object.\r\n */" } } }, "methods": { "method": { "deleteRow": { - "comment": "/**\r\n * Removes the specified row (tr) from the element and from the rows collection.\r\n * @param index Number that specifies the zero-based position in the rows collection of the row to remove.\r\n */" + "comment": "/**\r\n * Removes the specified row (tr) from the element and from the rows collection.\r\n * @param index Number that specifies the zero-based position in the rows collection of the row to remove.\r\n */" }, "createTBody": { - "comment": "/**\r\n * Creates an empty tBody element in the table.\r\n */" + "comment": "/**\r\n * Creates an empty tBody element in the table.\r\n */" }, "deleteCaption": { - "comment": "/**\r\n * Deletes the caption element and its contents from the table.\r\n */" + "comment": "/**\r\n * Deletes the caption element and its contents from the table.\r\n */" }, "insertRow": { - "comment": "/**\r\n * Creates a new row (tr) in the table, and adds the row to the rows collection.\r\n * @param index Number that specifies where to insert the row in the rows collection. The default value is -1, which appends the new row to the end of the rows collection.\r\n */" + "comment": "/**\r\n * Creates a new row (tr) in the table, and adds the row to the rows collection.\r\n * @param index Number that specifies where to insert the row in the rows collection. The default value is -1, which appends the new row to the end of the rows collection.\r\n */" }, "deleteTFoot": { - "comment": "/**\r\n * Deletes the tFoot element and its contents from the table.\r\n */" + "comment": "/**\r\n * Deletes the tFoot element and its contents from the table.\r\n */" }, "createTHead": { - "comment": "/**\r\n * Returns the tHead element object if successful, or null otherwise.\r\n */" + "comment": "/**\r\n * Returns the tHead element object if successful, or null otherwise.\r\n */" }, "deleteTHead": { - "comment": "/**\r\n * Deletes the tHead element and its contents from the table.\r\n */" + "comment": "/**\r\n * Deletes the tHead element and its contents from the table.\r\n */" }, "createCaption": { - "comment": "/**\r\n * Creates an empty caption element in the table.\r\n */" + "comment": "/**\r\n * Creates an empty caption element in the table.\r\n */" }, "createTFoot": { - "comment": "/**\r\n * Creates an empty tFoot element in the table.\r\n */" + "comment": "/**\r\n * Creates an empty tFoot element in the table.\r\n */" } } } @@ -284,10 +284,10 @@ "properties": { "property": { "target": { - "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" + "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" }, "href": { - "comment": "/**\r\n * Gets or sets the baseline URL on which relative links are based.\r\n */" + "comment": "/**\r\n * Gets or sets the baseline URL on which relative links are based.\r\n */" } } } @@ -296,7 +296,7 @@ "properties": { "property": { "align": { - "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" + "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" } } } @@ -305,19 +305,19 @@ "properties": { "property": { "archive": { - "comment": "/**\r\n * Sets or retrieves a character string that can be used to implement your own archive functionality for the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a character string that can be used to implement your own archive functionality for the object.\r\n */" }, "alt": { - "comment": "/**\r\n * Sets or retrieves a text alternative to the graphic.\r\n */" + "comment": "/**\r\n * Sets or retrieves a text alternative to the graphic.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the shape of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the shape of the object.\r\n */" }, "height": { - "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" }, "codeBase": { - "comment": "/**\r\n * Sets or retrieves the URL of the component.\r\n */" + "comment": "/**\r\n * Sets or retrieves the URL of the component.\r\n */" } } } @@ -326,7 +326,7 @@ "properties": { "property": { "start": { - "comment": "/**\r\n * The starting number.\r\n */" + "comment": "/**\r\n * The starting number.\r\n */" } } } @@ -335,65 +335,65 @@ "properties": { "property": { "value": { - "comment": "/**\r\n * Sets or retrieves the value which is returned to the server when the form control is submitted.\r\n */" + "comment": "/**\r\n * Sets or retrieves the value which is returned to the server when the form control is submitted.\r\n */" }, "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "size": { - "comment": "/**\r\n * Sets or retrieves the number of rows in the list box.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number of rows in the list box.\r\n */" }, "length": { - "comment": "/**\r\n * Sets or retrieves the number of objects in a collection.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number of objects in a collection.\r\n */" }, "selectedIndex": { - "comment": "/**\r\n * Sets or retrieves the index of the selected option in a select object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the index of the selected option in a select object.\r\n */" }, "multiple": { - "comment": "/**\r\n * Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.\r\n */" + "comment": "/**\r\n * Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.\r\n */" }, "type": { - "comment": "/**\r\n * Retrieves the type of select control based on the value of the MULTIPLE attribute.\r\n */" + "comment": "/**\r\n * Retrieves the type of select control based on the value of the MULTIPLE attribute.\r\n */" }, "validationMessage": { - "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" + "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" }, "autofocus": { - "comment": "/**\r\n * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing.\r\n */" + "comment": "/**\r\n * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing.\r\n */" }, "validity": { - "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" + "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" }, "required": { - "comment": "/**\r\n * When present, marks an element that can't be submitted without a value.\r\n */" + "comment": "/**\r\n * When present, marks an element that can't be submitted without a value.\r\n */" }, "willValidate": { - "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" + "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" } } }, "methods": { "method": { "remove": { - "comment": "/**\r\n * Removes an element from the collection.\r\n * @param index Number that specifies the zero-based index of the element to remove from the collection.\r\n */" + "comment": "/**\r\n * Removes an element from the collection.\r\n * @param index Number that specifies the zero-based index of the element to remove from the collection.\r\n */" }, "add": { - "comment": "/**\r\n * Adds an element to the areas, controlRange, or options collection.\r\n * @param element Variant of type Number that specifies the index position in the collection where the element is placed. If no value is given, the method places the element at the end of the collection.\r\n * @param before Variant of type Object that specifies an element to insert before, or null to append the object to the collection.\r\n */" + "comment": "/**\r\n * Adds an element to the areas, controlRange, or options collection.\r\n * @param element Variant of type Number that specifies the index position in the collection where the element is placed. If no value is given, the method places the element at the end of the collection.\r\n * @param before Variant of type Object that specifies an element to insert before, or null to append the object to the collection.\r\n */" }, "item": { - "comment": "/**\r\n * Retrieves a select object or an object from an options collection.\r\n * @param name Variant of type Number or String that specifies the object or collection to retrieve. If this parameter is an integer, it is the zero-based index of the object. If this parameter is a string, all objects with matching name or id properties are retrieved, and a collection is returned if more than one match is made.\r\n * @param index Variant of type Number that specifies the zero-based index of the object to retrieve when a collection is returned.\r\n */" + "comment": "/**\r\n * Retrieves a select object or an object from an options collection.\r\n * @param name Variant of type Number or String that specifies the object or collection to retrieve. If this parameter is an integer, it is the zero-based index of the object. If this parameter is a string, all objects with matching name or id properties are retrieved, and a collection is returned if more than one match is made.\r\n * @param index Variant of type Number that specifies the zero-based index of the object to retrieve when a collection is returned.\r\n */" }, "namedItem": { - "comment": "/**\r\n * Retrieves a select object or an object from an options collection.\r\n * @param namedItem A String that specifies the name or id property of the object to retrieve. A collection is returned if more than one match is made.\r\n */" + "comment": "/**\r\n * Retrieves a select object or an object from an options collection.\r\n * @param namedItem A String that specifies the name or id property of the object to retrieve. A collection is returned if more than one match is made.\r\n */" }, "checkValidity": { - "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" + "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" }, "setCustomValidity": { - "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" + "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" } } } @@ -402,16 +402,16 @@ "properties": { "property": { "httpEquiv": { - "comment": "/**\r\n * Gets or sets information used to bind the value of a content attribute of a meta element to an HTTP response header.\r\n */" + "comment": "/**\r\n * Gets or sets information used to bind the value of a content attribute of a meta element to an HTTP response header.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the value specified in the content attribute of the meta object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the value specified in the content attribute of the meta object.\r\n */" }, "content": { - "comment": "/**\r\n * Gets or sets meta-information to associate with httpEquiv or name.\r\n */" + "comment": "/**\r\n * Gets or sets meta-information to associate with httpEquiv or name.\r\n */" }, "scheme": { - "comment": "/**\r\n * Sets or retrieves a scheme to be used in interpreting the value of a property specified for the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a scheme to be used in interpreting the value of a property specified for the object.\r\n */" } } } @@ -420,28 +420,28 @@ "properties": { "property": { "rel": { - "comment": "/**\r\n * Sets or retrieves the relationship between the object and the destination of the link.\r\n */" + "comment": "/**\r\n * Sets or retrieves the relationship between the object and the destination of the link.\r\n */" }, "target": { - "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" + "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" }, "href": { - "comment": "/**\r\n * Sets or retrieves a destination URL or an anchor point.\r\n */" + "comment": "/**\r\n * Sets or retrieves a destination URL or an anchor point.\r\n */" }, "media": { - "comment": "/**\r\n * Sets or retrieves the media type.\r\n */" + "comment": "/**\r\n * Sets or retrieves the media type.\r\n */" }, "rev": { - "comment": "/**\r\n * Sets or retrieves the relationship between the object and the destination of the link.\r\n */" + "comment": "/**\r\n * Sets or retrieves the relationship between the object and the destination of the link.\r\n */" }, "type": { - "comment": "/**\r\n * Sets or retrieves the MIME type of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the MIME type of the object.\r\n */" }, "charset": { - "comment": "/**\r\n * Sets or retrieves the character set used to encode the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the character set used to encode the object.\r\n */" }, "hreflang": { - "comment": "/**\r\n * Sets or retrieves the language code of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the language code of the object.\r\n */" } } } @@ -450,7 +450,7 @@ "properties": { "property": { "face": { - "comment": "/**\r\n * Sets or retrieves the current typeface family.\r\n */" + "comment": "/**\r\n * Sets or retrieves the current typeface family.\r\n */" } } } @@ -459,7 +459,7 @@ "properties": { "property": { "align": { - "comment": "/**\r\n * Sets or retrieves the alignment of the caption or legend.\r\n */" + "comment": "/**\r\n * Sets or retrieves the alignment of the caption or legend.\r\n */" } } } @@ -468,25 +468,25 @@ "properties": { "property": { "index": { - "comment": "/**\r\n * Sets or retrieves the ordinal position of an option in a list box.\r\n */" + "comment": "/**\r\n * Sets or retrieves the ordinal position of an option in a list box.\r\n */" }, "defaultSelected": { - "comment": "/**\r\n * Sets or retrieves the status of an option.\r\n */" + "comment": "/**\r\n * Sets or retrieves the status of an option.\r\n */" }, "value": { - "comment": "/**\r\n * Sets or retrieves the value which is returned to the server when the form control is submitted.\r\n */" + "comment": "/**\r\n * Sets or retrieves the value which is returned to the server when the form control is submitted.\r\n */" }, "text": { - "comment": "/**\r\n * Sets or retrieves the text string specified by the option tag.\r\n */" + "comment": "/**\r\n * Sets or retrieves the text string specified by the option tag.\r\n */" }, "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" }, "label": { - "comment": "/**\r\n * Sets or retrieves a value that you can use to implement your own label functionality for the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a value that you can use to implement your own label functionality for the object.\r\n */" }, "selected": { - "comment": "/**\r\n * Sets or retrieves whether the option in the list box is the default item.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether the option in the list box is the default item.\r\n */" } } } @@ -495,10 +495,10 @@ "properties": { "property": { "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "areas": { - "comment": "/**\r\n * Retrieves a collection of the area objects defined for the given map object.\r\n */" + "comment": "/**\r\n * Retrieves a collection of the area objects defined for the given map object.\r\n */" } } } @@ -507,17 +507,17 @@ "properties": { "property": { "length": { - "comment": "/**\r\n * Sets or retrieves the number of objects in a collection.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number of objects in a collection.\r\n */" } } }, "methods": { "method": { "item": { - "comment": "/**\r\n * Retrieves an object from various collections.\r\n */" + "comment": "/**\r\n * Retrieves an object from various collections.\r\n */" }, "namedItem": { - "comment": "/**\r\n * Retrieves a select object or an object from an options collection.\r\n */" + "comment": "/**\r\n * Retrieves a select object or an object from an options collection.\r\n */" } } } @@ -526,49 +526,49 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "vspace": { - "comment": "/**\r\n * Sets or retrieves the vertical margin for the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the vertical margin for the object.\r\n */" }, "naturalHeight": { - "comment": "/**\r\n * The original height of the image resource before sizing.\r\n */" + "comment": "/**\r\n * The original height of the image resource before sizing.\r\n */" }, "alt": { - "comment": "/**\r\n * Sets or retrieves a text alternative to the graphic.\r\n */" + "comment": "/**\r\n * Sets or retrieves a text alternative to the graphic.\r\n */" }, "align": { - "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" + "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" }, "src": { - "comment": "/**\r\n * The address or URL of the a media resource that is to be considered.\r\n */" + "comment": "/**\r\n * The address or URL of the a media resource that is to be considered.\r\n */" }, "useMap": { - "comment": "/**\r\n * Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.\r\n */" + "comment": "/**\r\n * Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.\r\n */" }, "naturalWidth": { - "comment": "/**\r\n * The original width of the image resource before sizing.\r\n */" + "comment": "/**\r\n * The original width of the image resource before sizing.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "height": { - "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" }, "border": { - "comment": "/**\r\n * Specifies the properties of a border drawn around an object.\r\n */" + "comment": "/**\r\n * Specifies the properties of a border drawn around an object.\r\n */" }, "hspace": { - "comment": "/**\r\n * Sets or retrieves the width of the border to draw around the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the border to draw around the object.\r\n */" }, "longDesc": { - "comment": "/**\r\n * Sets or retrieves a Uniform Resource Identifier (URI) to a long description of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a Uniform Resource Identifier (URI) to a long description of the object.\r\n */" }, "isMap": { - "comment": "/**\r\n * Sets or retrieves whether the image is a server-side image map.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether the image is a server-side image map.\r\n */" }, "complete": { - "comment": "/**\r\n * Retrieves whether the object is fully loaded.\r\n */" + "comment": "/**\r\n * Retrieves whether the object is fully loaded.\r\n */" } } } @@ -577,19 +577,19 @@ "properties": { "property": { "alt": { - "comment": "/**\r\n * Sets or retrieves a text alternative to the graphic.\r\n */" + "comment": "/**\r\n * Sets or retrieves a text alternative to the graphic.\r\n */" }, "coords": { - "comment": "/**\r\n * Sets or retrieves the coordinates of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the coordinates of the object.\r\n */" }, "target": { - "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" + "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" }, "noHref": { - "comment": "/**\r\n * Sets or gets whether clicks in this region cause action.\r\n */" + "comment": "/**\r\n * Sets or gets whether clicks in this region cause action.\r\n */" }, "shape": { - "comment": "/**\r\n * Sets or retrieves the shape of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the shape of the object.\r\n */" } } } @@ -598,53 +598,53 @@ "properties": { "property": { "value": { - "comment": "/**\r\n * Sets or retrieves the default or selected value of the control.\r\n */" + "comment": "/**\r\n * Sets or retrieves the default or selected value of the control.\r\n */" }, "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "type": { - "comment": "/**\r\n * Gets the classification and default behavior of the button.\r\n */" + "comment": "/**\r\n * Gets the classification and default behavior of the button.\r\n */" }, "validationMessage": { - "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" + "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" }, "formTarget": { - "comment": "/**\r\n * Overrides the target attribute on a form element.\r\n */" + "comment": "/**\r\n * Overrides the target attribute on a form element.\r\n */" }, "willValidate": { - "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" + "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" }, "formAction": { - "comment": "/**\r\n * Overrides the action attribute (where the data on a form is sent) on the parent form element.\r\n */" + "comment": "/**\r\n * Overrides the action attribute (where the data on a form is sent) on the parent form element.\r\n */" }, "autofocus": { - "comment": "/**\r\n * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing.\r\n */" + "comment": "/**\r\n * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing.\r\n */" }, "validity": { - "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" + "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" }, "formNoValidate": { - "comment": "/**\r\n * Overrides any validation or required attributes on a form or form elements to allow it to be submitted without validation. This can be used to create a \"save draft\"-type submit option.\r\n */" + "comment": "/**\r\n * Overrides any validation or required attributes on a form or form elements to allow it to be submitted without validation. This can be used to create a \"save draft\"-type submit option.\r\n */" }, "formEnctype": { - "comment": "/**\r\n * Used to override the encoding (formEnctype attribute) specified on the form element.\r\n */" + "comment": "/**\r\n * Used to override the encoding (formEnctype attribute) specified on the form element.\r\n */" }, "formMethod": { - "comment": "/**\r\n * Overrides the submit method attribute previously specified on a form element.\r\n */" + "comment": "/**\r\n * Overrides the submit method attribute previously specified on a form element.\r\n */" } } }, "methods": { "method": { "checkValidity": { - "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" + "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" }, "setCustomValidity": { - "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" + "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" } } } @@ -653,13 +653,13 @@ "properties": { "property": { "src": { - "comment": "/**\r\n * The address or URL of the a media resource that is to be considered.\r\n */" + "comment": "/**\r\n * The address or URL of the a media resource that is to be considered.\r\n */" }, "media": { - "comment": "/**\r\n * Gets or sets the intended media type of the media source.\r\n */" + "comment": "/**\r\n * Gets or sets the intended media type of the media source.\r\n */" }, "type": { - "comment": "/**\r\n * Gets or sets the MIME type of a media resource.\r\n */" + "comment": "/**\r\n * Gets or sets the MIME type of a media resource.\r\n */" } } } @@ -668,7 +668,7 @@ "properties": { "property": { "styleSheets": { - "comment": "/**\r\n * Retrieves a collection of styleSheet objects representing the style sheets that correspond to each instance of a link or style object in the document.\r\n */" + "comment": "/**\r\n * Retrieves a collection of styleSheet objects representing the style sheets that correspond to each instance of a link or style object in the document.\r\n */" } } } @@ -677,182 +677,182 @@ "properties": { "property": { "implementation": { - "comment": "/**\r\n * Gets the implementation object of the current document.\r\n */" + "comment": "/**\r\n * Gets the implementation object of the current document.\r\n */" }, "scripts": { - "comment": "/**\r\n * Retrieves a collection of all script objects in the document.\r\n */" + "comment": "/**\r\n * Retrieves a collection of all script objects in the document.\r\n */" }, "charset": { - "comment": "/**\r\n * Gets or sets the character set used to encode the object.\r\n */" + "comment": "/**\r\n * Gets or sets the character set used to encode the object.\r\n */" }, "vlinkColor": { - "comment": "/**\r\n * Sets or gets the color of the links that the user has visited.\r\n */" + "comment": "/**\r\n * Sets or gets the color of the links that the user has visited.\r\n */" }, "title": { - "comment": "/**\r\n * Contains the title of the document.\r\n */" + "comment": "/**\r\n * Contains the title of the document.\r\n */" }, "embeds": { - "comment": "/**\r\n * Retrieves a collection of all embed objects in the document.\r\n */" + "comment": "/**\r\n * Retrieves a collection of all embed objects in the document.\r\n */" }, "all": { - "comment": "/**\r\n * Returns a reference to the collection of elements contained by the object.\r\n */" + "comment": "/**\r\n * Returns a reference to the collection of elements contained by the object.\r\n */" }, "forms": { - "comment": "/**\r\n * Retrieves a collection, in source order, of all form objects in the document.\r\n */" + "comment": "/**\r\n * Retrieves a collection, in source order, of all form objects in the document.\r\n */" }, "dir": { - "comment": "/**\r\n * Sets or retrieves a value that indicates the reading order of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a value that indicates the reading order of the object.\r\n */" }, "designMode": { - "comment": "/**\r\n * Sets or gets a value that indicates whether the document can be edited.\r\n */" + "comment": "/**\r\n * Sets or gets a value that indicates whether the document can be edited.\r\n */" }, "inputEncoding": { - "comment": "/**\r\n * Returns the character encoding used to create the webpage that is loaded into the document object.\r\n */" + "comment": "/**\r\n * Returns the character encoding used to create the webpage that is loaded into the document object.\r\n */" }, "activeElement": { - "comment": "/**\r\n * Gets the object that has the focus when the parent document has focus.\r\n */" + "comment": "/**\r\n * Gets the object that has the focus when the parent document has focus.\r\n */" }, "links": { - "comment": "/**\r\n * Retrieves a collection of all a objects that specify the href property and all area objects in the document.\r\n */" + "comment": "/**\r\n * Retrieves a collection of all a objects that specify the href property and all area objects in the document.\r\n */" }, "URL": { - "comment": "/**\r\n * Sets or gets the URL for the current document.\r\n */" + "comment": "/**\r\n * Sets or gets the URL for the current document.\r\n */" }, "anchors": { - "comment": "/**\r\n * Retrieves a collection of all a objects that have a name and/or id property. Objects in this collection are in HTML source order.\r\n */" + "comment": "/**\r\n * Retrieves a collection of all a objects that have a name and/or id property. Objects in this collection are in HTML source order.\r\n */" }, "readyState": { - "comment": "/**\r\n * Retrieves a value that indicates the current state of the object.\r\n */" + "comment": "/**\r\n * Retrieves a value that indicates the current state of the object.\r\n */" }, "referrer": { - "comment": "/**\r\n * Gets the URL of the location that referred the user to the current page.\r\n */" + "comment": "/**\r\n * Gets the URL of the location that referred the user to the current page.\r\n */" }, "alinkColor": { - "comment": "/**\r\n * Sets or gets the color of all active links in the document.\r\n */" + "comment": "/**\r\n * Sets or gets the color of all active links in the document.\r\n */" }, "doctype": { - "comment": "/**\r\n * Gets an object representing the document type declaration associated with the current document.\r\n */" + "comment": "/**\r\n * Gets an object representing the document type declaration associated with the current document.\r\n */" }, "bgColor": { - "comment": "/**\r\n * Deprecated. Sets or retrieves a value that indicates the background color behind the object.\r\n */" + "comment": "/**\r\n * Deprecated. Sets or retrieves a value that indicates the background color behind the object.\r\n */" }, "linkColor": { - "comment": "/**\r\n * Sets or gets the color of the document links.\r\n */" + "comment": "/**\r\n * Sets or gets the color of the document links.\r\n */" }, "applets": { - "comment": "/**\r\n * Retrieves a collection of all applet objects in the document.\r\n */" + "comment": "/**\r\n * Retrieves a collection of all applet objects in the document.\r\n */" }, "body": { - "comment": "/**\r\n * Specifies the beginning and end of the document body.\r\n */" + "comment": "/**\r\n * Specifies the beginning and end of the document body.\r\n */" }, "domain": { - "comment": "/**\r\n * Sets or gets the security domain of the document.\r\n */" + "comment": "/**\r\n * Sets or gets the security domain of the document.\r\n */" }, "documentElement": { - "comment": "/**\r\n * Gets a reference to the root node of the document.\r\n */" + "comment": "/**\r\n * Gets a reference to the root node of the document.\r\n */" }, "images": { - "comment": "/**\r\n * Retrieves a collection, in source order, of img objects in the document.\r\n */" + "comment": "/**\r\n * Retrieves a collection, in source order, of img objects in the document.\r\n */" }, "location": { - "comment": "/**\r\n * Contains information about the current URL.\r\n */" + "comment": "/**\r\n * Contains information about the current URL.\r\n */" }, "onreadystatechange": { - "comment": "/**\r\n * Fires when the state of the object has changed.\r\n * @param ev The event\r\n */" + "comment": "/**\r\n * Fires when the state of the object has changed.\r\n * @param ev The event\r\n */" }, "lastModified": { - "comment": "/**\r\n * Gets the date that the page was last modified, if the page supplies one.\r\n */" + "comment": "/**\r\n * Gets the date that the page was last modified, if the page supplies one.\r\n */" }, "fgColor": { - "comment": "/**\r\n * Sets or gets the foreground (text) color of the document.\r\n */" + "comment": "/**\r\n * Sets or gets the foreground (text) color of the document.\r\n */" }, "compatMode": { - "comment": "/**\r\n * Gets a value that indicates whether standards-compliant mode is switched on for the object.\r\n */" + "comment": "/**\r\n * Gets a value that indicates whether standards-compliant mode is switched on for the object.\r\n */" } } }, "methods": { "method": { "queryCommandValue": { - "comment": "/**\r\n * Returns the current value of the document, range, or current selection for the given command.\r\n * @param commandId String that specifies a command identifier.\r\n */" + "comment": "/**\r\n * Returns the current value of the document, range, or current selection for the given command.\r\n * @param commandId String that specifies a command identifier.\r\n */" }, "queryCommandIndeterm": { - "comment": "/**\r\n * Returns a Boolean value that indicates whether the specified command is in the indeterminate state.\r\n * @param commandId String that specifies a command identifier.\r\n */" + "comment": "/**\r\n * Returns a Boolean value that indicates whether the specified command is in the indeterminate state.\r\n * @param commandId String that specifies a command identifier.\r\n */" }, "execCommand": { - "comment": "/**\r\n * Executes a command on the current document, current selection, or the given range.\r\n * @param commandId String that specifies the command to execute. This command can be any of the command identifiers that can be executed in script.\r\n * @param showUI Display the user interface, defaults to false.\r\n * @param value Value to assign.\r\n */" + "comment": "/**\r\n * Executes a command on the current document, current selection, or the given range.\r\n * @param commandId String that specifies the command to execute. This command can be any of the command identifiers that can be executed in script.\r\n * @param showUI Display the user interface, defaults to false.\r\n * @param value Value to assign.\r\n */" }, "elementFromPoint": { - "comment": "/**\r\n * Returns the element for the specified x coordinate and the specified y coordinate.\r\n * @param x The x-offset\r\n * @param y The y-offset\r\n */" + "comment": "/**\r\n * Returns the element for the specified x coordinate and the specified y coordinate.\r\n * @param x The x-offset\r\n * @param y The y-offset\r\n */" }, "queryCommandText": { - "comment": "/**\r\n * Retrieves the string associated with a command.\r\n * @param commandId String that contains the identifier of a command. This can be any command identifier given in the list of Command Identifiers.\r\n */" + "comment": "/**\r\n * Retrieves the string associated with a command.\r\n * @param commandId String that contains the identifier of a command. This can be any command identifier given in the list of Command Identifiers.\r\n */" }, "write": { - "comment": "/**\r\n * Writes one or more HTML expressions to a document in the specified window.\r\n * @param content Specifies the text and HTML tags to write.\r\n */" + "comment": "/**\r\n * Writes one or more HTML expressions to a document in the specified window.\r\n * @param content Specifies the text and HTML tags to write.\r\n */" }, "createElement": { - "comment": "/**\r\n * Creates an instance of the element for the specified tag.\r\n * @param tagName The name of an element.\r\n */" + "comment": "/**\r\n * Creates an instance of the element for the specified tag.\r\n * @param tagName The name of an element.\r\n */" }, "writeln": { - "comment": "/**\r\n * Writes one or more HTML expressions, followed by a carriage return, to a document in the specified window.\r\n * @param content The text and HTML tags to write.\r\n */" + "comment": "/**\r\n * Writes one or more HTML expressions, followed by a carriage return, to a document in the specified window.\r\n * @param content The text and HTML tags to write.\r\n */" }, "open": { - "comment": "/**\r\n * Opens a new window and loads a document specified by a given URL. Also, opens a new window that uses the url parameter and the name parameter to collect the output of the write method and the writeln method.\r\n * @param url Specifies a MIME type for the document.\r\n * @param name Specifies the name of the window. This name is used as the value for the TARGET attribute on a form or an anchor element.\r\n * @param features Contains a list of items separated by commas. Each item consists of an option and a value, separated by an equals sign (for example, \"fullscreen=yes, toolbar=yes\"). The following values are supported.\r\n * @param replace Specifies whether the existing entry for the document is replaced in the history list.\r\n */" + "comment": "/**\r\n * Opens a new window and loads a document specified by a given URL. Also, opens a new window that uses the url parameter and the name parameter to collect the output of the write method and the writeln method.\r\n * @param url Specifies a MIME type for the document.\r\n * @param name Specifies the name of the window. This name is used as the value for the TARGET attribute on a form or an anchor element.\r\n * @param features Contains a list of items separated by commas. Each item consists of an option and a value, separated by an equals sign (for example, \"fullscreen=yes, toolbar=yes\"). The following values are supported.\r\n * @param replace Specifies whether the existing entry for the document is replaced in the history list.\r\n */" }, "queryCommandSupported": { - "comment": "/**\r\n * Returns a Boolean value that indicates whether the current command is supported on the current range.\r\n * @param commandId Specifies a command identifier.\r\n */" + "comment": "/**\r\n * Returns a Boolean value that indicates whether the current command is supported on the current range.\r\n * @param commandId Specifies a command identifier.\r\n */" }, "createTreeWalker": { - "comment": "/**\r\n * Creates a TreeWalker object that you can use to traverse filtered lists of nodes or elements in a document.\r\n * @param root The root element or node to start traversing on.\r\n * @param whatToShow The type of nodes or elements to appear in the node list. For more information, see whatToShow.\r\n * @param filter A custom NodeFilter function to use.\r\n * @param entityReferenceExpansion A flag that specifies whether entity reference nodes are expanded.\r\n */" + "comment": "/**\r\n * Creates a TreeWalker object that you can use to traverse filtered lists of nodes or elements in a document.\r\n * @param root The root element or node to start traversing on.\r\n * @param whatToShow The type of nodes or elements to appear in the node list. For more information, see whatToShow.\r\n * @param filter A custom NodeFilter function to use.\r\n * @param entityReferenceExpansion A flag that specifies whether entity reference nodes are expanded.\r\n */" }, "queryCommandEnabled": { - "comment": "/**\r\n * Returns a Boolean value that indicates whether a specified command can be successfully executed using execCommand, given the current state of the document.\r\n * @param commandId Specifies a command identifier.\r\n */" + "comment": "/**\r\n * Returns a Boolean value that indicates whether a specified command can be successfully executed using execCommand, given the current state of the document.\r\n * @param commandId Specifies a command identifier.\r\n */" }, "focus": { - "comment": "/**\r\n * Causes the element to receive the focus and executes the code specified by the onfocus event.\r\n */" + "comment": "/**\r\n * Causes the element to receive the focus and executes the code specified by the onfocus event.\r\n */" }, "close": { - "comment": "/**\r\n * Closes an output stream and forces the sent data to display.\r\n */" + "comment": "/**\r\n * Closes an output stream and forces the sent data to display.\r\n */" }, "createRange": { - "comment": "/**\r\n * Returns an empty range object that has both of its boundary points positioned at the beginning of the document.\r\n */" + "comment": "/**\r\n * Returns an empty range object that has both of its boundary points positioned at the beginning of the document.\r\n */" }, "createComment": { - "comment": "/**\r\n * Creates a comment object with the specified data.\r\n * @param data Sets the comment object's data.\r\n */" + "comment": "/**\r\n * Creates a comment object with the specified data.\r\n * @param data Sets the comment object's data.\r\n */" }, "getElementsByTagName": { - "comment": "/**\r\n * Retrieves a collection of objects based on the specified element name.\r\n * @param name Specifies the name of an element.\r\n */" + "comment": "/**\r\n * Retrieves a collection of objects based on the specified element name.\r\n * @param name Specifies the name of an element.\r\n */" }, "createDocumentFragment": { - "comment": "/**\r\n * Creates a new document.\r\n */" + "comment": "/**\r\n * Creates a new document.\r\n */" }, "getElementsByName": { - "comment": "/**\r\n * Gets a collection of objects based on the value of the NAME or ID attribute.\r\n * @param elementName Gets a collection of objects based on the value of the NAME or ID attribute.\r\n */" + "comment": "/**\r\n * Gets a collection of objects based on the value of the NAME or ID attribute.\r\n * @param elementName Gets a collection of objects based on the value of the NAME or ID attribute.\r\n */" }, "queryCommandState": { - "comment": "/**\r\n * Returns a Boolean value that indicates the current state of the command.\r\n * @param commandId String that specifies a command identifier.\r\n */" + "comment": "/**\r\n * Returns a Boolean value that indicates the current state of the command.\r\n * @param commandId String that specifies a command identifier.\r\n */" }, "hasFocus": { - "comment": "/**\r\n * Gets a value indicating whether the object currently has focus.\r\n */" + "comment": "/**\r\n * Gets a value indicating whether the object currently has focus.\r\n */" }, "execCommandShowHelp": { - "comment": "/**\r\n * Displays help information for the given command identifier.\r\n * @param commandId Displays help information for the given command identifier.\r\n */" + "comment": "/**\r\n * Displays help information for the given command identifier.\r\n * @param commandId Displays help information for the given command identifier.\r\n */" }, "createAttribute": { - "comment": "/**\r\n * Creates an attribute object with a specified name.\r\n * @param name String that sets the attribute object's name.\r\n */" + "comment": "/**\r\n * Creates an attribute object with a specified name.\r\n * @param name String that sets the attribute object's name.\r\n */" }, "createTextNode": { - "comment": "/**\r\n * Creates a text string from the specified value.\r\n * @param data String that specifies the nodeValue property of the text node.\r\n */" + "comment": "/**\r\n * Creates a text string from the specified value.\r\n * @param data String that specifies the nodeValue property of the text node.\r\n */" }, "createNodeIterator": { - "comment": "/**\r\n * Creates a NodeIterator object that you can use to traverse filtered lists of nodes or elements in a document.\r\n * @param root The root element or node to start traversing on.\r\n * @param whatToShow The type of nodes or elements to appear in the node list\r\n * @param filter A custom NodeFilter function to use. For more information, see filter. Use null for no filter.\r\n * @param entityReferenceExpansion A flag that specifies whether entity reference nodes are expanded.\r\n */" + "comment": "/**\r\n * Creates a NodeIterator object that you can use to traverse filtered lists of nodes or elements in a document.\r\n * @param root The root element or node to start traversing on.\r\n * @param whatToShow The type of nodes or elements to appear in the node list\r\n * @param filter A custom NodeFilter function to use. For more information, see filter. Use null for no filter.\r\n * @param entityReferenceExpansion A flag that specifies whether entity reference nodes are expanded.\r\n */" }, "getSelection": { - "comment": "/**\r\n * Returns an object representing the current selection of the document that is loaded into the object displaying a webpage.\r\n */" + "comment": "/**\r\n * Returns an object representing the current selection of the document that is loaded into the object displaying a webpage.\r\n */" }, "getElementById": { - "comment": "/**\r\n * Returns a reference to the first object with the specified value of the ID or NAME attribute.\r\n * @param elementId String that specifies the ID value. Case-insensitive.\r\n */" + "comment": "/**\r\n * Returns a reference to the first object with the specified value of the ID or NAME attribute.\r\n * @param elementId String that specifies the ID value. Case-insensitive.\r\n */" } } } @@ -861,25 +861,25 @@ "properties": { "property": { "defer": { - "comment": "/**\r\n * Sets or retrieves the status of the script.\r\n */" + "comment": "/**\r\n * Sets or retrieves the status of the script.\r\n */" }, "text": { - "comment": "/**\r\n * Retrieves or sets the text of the object as a string.\r\n */" + "comment": "/**\r\n * Retrieves or sets the text of the object as a string.\r\n */" }, "src": { - "comment": "/**\r\n * Retrieves the URL to an external file that contains the source code or data.\r\n */" + "comment": "/**\r\n * Retrieves the URL to an external file that contains the source code or data.\r\n */" }, "htmlFor": { - "comment": "/**\r\n * Sets or retrieves the object that is bound to the event script.\r\n */" + "comment": "/**\r\n * Sets or retrieves the object that is bound to the event script.\r\n */" }, "charset": { - "comment": "/**\r\n * Sets or retrieves the character set used to encode the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the character set used to encode the object.\r\n */" }, "type": { - "comment": "/**\r\n * Sets or retrieves the MIME type for the associated scripting engine.\r\n */" + "comment": "/**\r\n * Sets or retrieves the MIME type for the associated scripting engine.\r\n */" }, "event": { - "comment": "/**\r\n * Sets or retrieves the event for which the script is written.\r\n */" + "comment": "/**\r\n * Sets or retrieves the event for which the script is written.\r\n */" } } } @@ -888,26 +888,26 @@ "properties": { "property": { "rowIndex": { - "comment": "/**\r\n * Retrieves the position of the object in the rows collection for the table.\r\n */" + "comment": "/**\r\n * Retrieves the position of the object in the rows collection for the table.\r\n */" }, "cells": { - "comment": "/**\r\n * Retrieves a collection of all cells in the table row.\r\n */" + "comment": "/**\r\n * Retrieves a collection of all cells in the table row.\r\n */" }, "align": { - "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" + "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" }, "sectionRowIndex": { - "comment": "/**\r\n * Retrieves the position of the object in the collection.\r\n */" + "comment": "/**\r\n * Retrieves the position of the object in the collection.\r\n */" } } }, "methods": { "method": { "deleteCell": { - "comment": "/**\r\n * Removes the specified cell from the table row, as well as from the cells collection.\r\n * @param index Number that specifies the zero-based position of the cell to remove from the table row. If no value is provided, the last cell in the cells collection is deleted.\r\n */" + "comment": "/**\r\n * Removes the specified cell from the table row, as well as from the cells collection.\r\n * @param index Number that specifies the zero-based position of the cell to remove from the table row. If no value is provided, the last cell in the cells collection is deleted.\r\n */" }, "insertCell": { - "comment": "/**\r\n * Creates a new cell in the table row, and adds the cell to the cells collection.\r\n * @param index Number that specifies where to insert the cell in the tr. The default value is -1, which appends the new cell to the end of the cells collection.\r\n */" + "comment": "/**\r\n * Creates a new cell in the table row, and adds the cell to the cells collection.\r\n * @param index Number that specifies where to insert the cell in the tr. The default value is -1, which appends the new cell to the end of the cells collection.\r\n */" } } } @@ -916,7 +916,7 @@ "properties": { "property": { "version": { - "comment": "/**\r\n * Sets or retrieves the DTD version that governs the current document.\r\n */" + "comment": "/**\r\n * Sets or retrieves the DTD version that governs the current document.\r\n */" } } } @@ -925,34 +925,34 @@ "properties": { "property": { "scrolling": { - "comment": "/**\r\n * Sets or retrieves whether the frame can be scrolled.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether the frame can be scrolled.\r\n */" }, "marginHeight": { - "comment": "/**\r\n * Sets or retrieves the top and bottom margin heights before displaying the text in a frame.\r\n */" + "comment": "/**\r\n * Sets or retrieves the top and bottom margin heights before displaying the text in a frame.\r\n */" }, "marginWidth": { - "comment": "/**\r\n * Sets or retrieves the left and right margin widths before displaying the text in a frame.\r\n */" + "comment": "/**\r\n * Sets or retrieves the left and right margin widths before displaying the text in a frame.\r\n */" }, "frameBorder": { - "comment": "/**\r\n * Sets or retrieves whether to display a border for the frame.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether to display a border for the frame.\r\n */" }, "noResize": { - "comment": "/**\r\n * Sets or retrieves whether the user can resize the frame.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether the user can resize the frame.\r\n */" }, "contentWindow": { - "comment": "/**\r\n * Retrieves the object of the specified.\r\n */" + "comment": "/**\r\n * Retrieves the object of the specified.\r\n */" }, "src": { - "comment": "/**\r\n * Sets or retrieves a URL to be loaded by the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a URL to be loaded by the object.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the frame name.\r\n */" + "comment": "/**\r\n * Sets or retrieves the frame name.\r\n */" }, "contentDocument": { - "comment": "/**\r\n * Retrieves the document object of the page or frame.\r\n */" + "comment": "/**\r\n * Retrieves the document object of the page or frame.\r\n */" }, "longDesc": { - "comment": "/**\r\n * Sets or retrieves a URI to a long description of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a URI to a long description of the object.\r\n */" } } } @@ -961,7 +961,7 @@ "properties": { "property": { "cite": { - "comment": "/**\r\n * Sets or retrieves reference information about the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves reference information about the object.\r\n */" } } } @@ -970,10 +970,10 @@ "properties": { "property": { "rows": { - "comment": "/**\r\n * Sets or retrieves the frame heights of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the frame heights of the object.\r\n */" }, "cols": { - "comment": "/**\r\n * Sets or retrieves the frame widths of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the frame widths of the object.\r\n */" } } } @@ -982,10 +982,10 @@ "properties": { "property": { "htmlFor": { - "comment": "/**\r\n * Sets or retrieves the object to which the given label object is assigned.\r\n */" + "comment": "/**\r\n * Sets or retrieves the object to which the given label object is assigned.\r\n */" }, "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" } } } @@ -994,7 +994,7 @@ "properties": { "property": { "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" } } } @@ -1003,7 +1003,7 @@ "properties": { "property": { "value": { - "comment": "/**\r\n * Sets or retrieves the value of a list item.\r\n */" + "comment": "/**\r\n * Sets or retrieves the value of a list item.\r\n */" } } } @@ -1012,43 +1012,43 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "scrolling": { - "comment": "/**\r\n * Sets or retrieves whether the frame can be scrolled.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether the frame can be scrolled.\r\n */" }, "marginHeight": { - "comment": "/**\r\n * Sets or retrieves the top and bottom margin heights before displaying the text in a frame.\r\n */" + "comment": "/**\r\n * Sets or retrieves the top and bottom margin heights before displaying the text in a frame.\r\n */" }, "marginWidth": { - "comment": "/**\r\n * Sets or retrieves the left and right margin widths before displaying the text in a frame.\r\n */" + "comment": "/**\r\n * Sets or retrieves the left and right margin widths before displaying the text in a frame.\r\n */" }, "frameBorder": { - "comment": "/**\r\n * Sets or retrieves whether to display a border for the frame.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether to display a border for the frame.\r\n */" }, "contentWindow": { - "comment": "/**\r\n * Retrieves the object of the specified.\r\n */" + "comment": "/**\r\n * Retrieves the object of the specified.\r\n */" }, "align": { - "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" + "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" }, "src": { - "comment": "/**\r\n * Sets or retrieves a URL to be loaded by the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a URL to be loaded by the object.\r\n */" }, "srcdoc": { - "comment": "/**\r\n * Sets or retrives the content of the page that is to contain.\r\n */" + "comment": "/**\r\n * Sets or retrives the content of the page that is to contain.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the frame name.\r\n */" + "comment": "/**\r\n * Sets or retrieves the frame name.\r\n */" }, "height": { - "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" }, "contentDocument": { - "comment": "/**\r\n * Retrieves the document object of the page or frame.\r\n */" + "comment": "/**\r\n * Retrieves the document object of the page or frame.\r\n */" }, "longDesc": { - "comment": "/**\r\n * Sets or retrieves a URI to a long description of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a URI to a long description of the object.\r\n */" } } } @@ -1057,20 +1057,20 @@ "properties": { "property": { "align": { - "comment": "/**\r\n * Sets or retrieves a value that indicates the table alignment.\r\n */" + "comment": "/**\r\n * Sets or retrieves a value that indicates the table alignment.\r\n */" }, "rows": { - "comment": "/**\r\n * Sets or retrieves the number of horizontal rows contained in the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number of horizontal rows contained in the object.\r\n */" } } }, "methods": { "method": { "deleteRow": { - "comment": "/**\r\n * Removes the specified row (tr) from the element and from the rows collection.\r\n * @param index Number that specifies the zero-based position in the rows collection of the row to remove.\r\n */" + "comment": "/**\r\n * Removes the specified row (tr) from the element and from the rows collection.\r\n * @param index Number that specifies the zero-based position in the rows collection of the row to remove.\r\n */" }, "insertRow": { - "comment": "/**\r\n * Creates a new row (tr) in the table, and adds the row to the rows collection.\r\n * @param index Number that specifies where to insert the row in the rows collection. The default value is -1, which appends the new row to the end of the rows collection.\r\n */" + "comment": "/**\r\n * Creates a new row (tr) in the table, and adds the row to the rows collection.\r\n * @param index Number that specifies where to insert the row in the rows collection. The default value is -1, which appends the new row to the end of the rows collection.\r\n */" } } } @@ -1079,137 +1079,137 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" }, "selectionStart": { - "comment": "/**\r\n * Gets or sets the starting position or offset of a text selection.\r\n */" + "comment": "/**\r\n * Gets or sets the starting position or offset of a text selection.\r\n */" }, "selectionEnd": { - "comment": "/**\r\n * Gets or sets the end position or offset of a text selection.\r\n */" + "comment": "/**\r\n * Gets or sets the end position or offset of a text selection.\r\n */" }, "accept": { - "comment": "/**\r\n * Sets or retrieves a comma-separated list of content types.\r\n */" + "comment": "/**\r\n * Sets or retrieves a comma-separated list of content types.\r\n */" }, "alt": { - "comment": "/**\r\n * Sets or retrieves a text alternative to the graphic.\r\n */" + "comment": "/**\r\n * Sets or retrieves a text alternative to the graphic.\r\n */" }, "defaultChecked": { - "comment": "/**\r\n * Sets or retrieves the state of the check box or radio button.\r\n */" + "comment": "/**\r\n * Sets or retrieves the state of the check box or radio button.\r\n */" }, "align": { - "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" + "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" }, "value": { - "comment": "/**\r\n * Returns the value of the data at the cursor's current position.\r\n */" + "comment": "/**\r\n * Returns the value of the data at the cursor's current position.\r\n */" }, "src": { - "comment": "/**\r\n * The address or URL of the a media resource that is to be considered.\r\n */" + "comment": "/**\r\n * The address or URL of the a media resource that is to be considered.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "useMap": { - "comment": "/**\r\n * Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.\r\n */" + "comment": "/**\r\n * Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.\r\n */" }, "height": { - "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" }, "checked": { - "comment": "/**\r\n * Sets or retrieves the state of the check box or radio button.\r\n */" + "comment": "/**\r\n * Sets or retrieves the state of the check box or radio button.\r\n */" }, "maxLength": { - "comment": "/**\r\n * Sets or retrieves the maximum number of characters that the user can enter in a text control.\r\n */" + "comment": "/**\r\n * Sets or retrieves the maximum number of characters that the user can enter in a text control.\r\n */" }, "type": { - "comment": "/**\r\n * Returns the content type of the object.\r\n */" + "comment": "/**\r\n * Returns the content type of the object.\r\n */" }, "defaultValue": { - "comment": "/**\r\n * Sets or retrieves the initial contents of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the initial contents of the object.\r\n */" }, "validationMessage": { - "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" + "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" }, "files": { - "comment": "/**\r\n * Returns a FileList object on a file type input object.\r\n */" + "comment": "/**\r\n * Returns a FileList object on a file type input object.\r\n */" }, "max": { - "comment": "/**\r\n * Defines the maximum acceptable value for an input element with type=\"number\".When used with the min and step attributes, lets you control the range and increment (such as only even numbers) that the user can enter into an input field.\r\n */" + "comment": "/**\r\n * Defines the maximum acceptable value for an input element with type=\"number\".When used with the min and step attributes, lets you control the range and increment (such as only even numbers) that the user can enter into an input field.\r\n */" }, "formTarget": { - "comment": "/**\r\n * Overrides the target attribute on a form element.\r\n */" + "comment": "/**\r\n * Overrides the target attribute on a form element.\r\n */" }, "willValidate": { - "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" + "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" }, "step": { - "comment": "/**\r\n * Defines an increment or jump between values that you want to allow the user to enter. When used with the max and min attributes, lets you control the range and increment (for example, allow only even numbers) that the user can enter into an input field.\r\n */" + "comment": "/**\r\n * Defines an increment or jump between values that you want to allow the user to enter. When used with the max and min attributes, lets you control the range and increment (for example, allow only even numbers) that the user can enter into an input field.\r\n */" }, "autofocus": { - "comment": "/**\r\n * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing.\r\n */" + "comment": "/**\r\n * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing.\r\n */" }, "required": { - "comment": "/**\r\n * When present, marks an element that can't be submitted without a value.\r\n */" + "comment": "/**\r\n * When present, marks an element that can't be submitted without a value.\r\n */" }, "formEnctype": { - "comment": "/**\r\n * Used to override the encoding (formEnctype attribute) specified on the form element.\r\n */" + "comment": "/**\r\n * Used to override the encoding (formEnctype attribute) specified on the form element.\r\n */" }, "valueAsNumber": { - "comment": "/**\r\n * Returns the input field value as a number.\r\n */" + "comment": "/**\r\n * Returns the input field value as a number.\r\n */" }, "placeholder": { - "comment": "/**\r\n * Gets or sets a text string that is displayed in an input field as a hint or prompt to users as the format or type of information they need to enter.The text appears in an input field until the user puts focus on the field.\r\n */" + "comment": "/**\r\n * Gets or sets a text string that is displayed in an input field as a hint or prompt to users as the format or type of information they need to enter.The text appears in an input field until the user puts focus on the field.\r\n */" }, "formMethod": { - "comment": "/**\r\n * Overrides the submit method attribute previously specified on a form element.\r\n */" + "comment": "/**\r\n * Overrides the submit method attribute previously specified on a form element.\r\n */" }, "list": { - "comment": "/**\r\n * Specifies the ID of a pre-defined datalist of options for an input element.\r\n */" + "comment": "/**\r\n * Specifies the ID of a pre-defined datalist of options for an input element.\r\n */" }, "autocomplete": { - "comment": "/**\r\n * Specifies whether autocomplete is applied to an editable text field.\r\n */" + "comment": "/**\r\n * Specifies whether autocomplete is applied to an editable text field.\r\n */" }, "min": { - "comment": "/**\r\n * Defines the minimum acceptable value for an input element with type=\"number\". When used with the max and step attributes, lets you control the range and increment (such as even numbers only) that the user can enter into an input field.\r\n */" + "comment": "/**\r\n * Defines the minimum acceptable value for an input element with type=\"number\". When used with the max and step attributes, lets you control the range and increment (such as even numbers only) that the user can enter into an input field.\r\n */" }, "formAction": { - "comment": "/**\r\n * Overrides the action attribute (where the data on a form is sent) on the parent form element.\r\n */" + "comment": "/**\r\n * Overrides the action attribute (where the data on a form is sent) on the parent form element.\r\n */" }, "pattern": { - "comment": "/**\r\n * Gets or sets a string containing a regular expression that the user's input must match.\r\n */" + "comment": "/**\r\n * Gets or sets a string containing a regular expression that the user's input must match.\r\n */" }, "validity": { - "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" + "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" }, "formNoValidate": { - "comment": "/**\r\n * Overrides any validation or required attributes on a form or form elements to allow it to be submitted without validation. This can be used to create a \"save draft\"-type submit option.\r\n */" + "comment": "/**\r\n * Overrides any validation or required attributes on a form or form elements to allow it to be submitted without validation. This can be used to create a \"save draft\"-type submit option.\r\n */" }, "multiple": { - "comment": "/**\r\n * Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.\r\n */" + "comment": "/**\r\n * Sets or retrieves the Boolean value indicating whether multiple items can be selected from a list.\r\n */" } } }, "methods": { "method": { "setSelectionRange": { - "comment": "/**\r\n * Sets the start and end positions of a selection in a text field.\r\n * @param start The offset into the text field for the start of the selection.\r\n * @param end The offset into the text field for the end of the selection.\r\n * @param direction The direction in which the selection is performed.\r\n */" + "comment": "/**\r\n * Sets the start and end positions of a selection in a text field.\r\n * @param start The offset into the text field for the start of the selection.\r\n * @param end The offset into the text field for the end of the selection.\r\n * @param direction The direction in which the selection is performed.\r\n */" }, "select": { - "comment": "/**\r\n * Makes the selection equal to the current object.\r\n */" + "comment": "/**\r\n * Makes the selection equal to the current object.\r\n */" }, "checkValidity": { - "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" + "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" }, "stepDown": { - "comment": "/**\r\n * Decrements a range input control's value by the value given by the Step attribute. If the optional parameter is used, it will decrement the input control's step value multiplied by the parameter's value.\r\n * @param n Value to decrement the value by.\r\n */" + "comment": "/**\r\n * Decrements a range input control's value by the value given by the Step attribute. If the optional parameter is used, it will decrement the input control's step value multiplied by the parameter's value.\r\n * @param n Value to decrement the value by.\r\n */" }, "stepUp": { - "comment": "/**\r\n * Increments a range input control's value by the value given by the Step attribute. If the optional parameter is used, will increment the input control's value by that value.\r\n * @param n Value to increment the value by.\r\n */" + "comment": "/**\r\n * Increments a range input control's value by the value given by the Step attribute. If the optional parameter is used, will increment the input control's value by that value.\r\n * @param n Value to increment the value by.\r\n */" }, "setCustomValidity": { - "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" + "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" } } } @@ -1218,31 +1218,31 @@ "properties": { "property": { "rel": { - "comment": "/**\r\n * Sets or retrieves the relationship between the object and the destination of the link.\r\n */" + "comment": "/**\r\n * Sets or retrieves the relationship between the object and the destination of the link.\r\n */" }, "coords": { - "comment": "/**\r\n * Sets or retrieves the coordinates of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the coordinates of the object.\r\n */" }, "target": { - "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" + "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the shape of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the shape of the object.\r\n */" }, "charset": { - "comment": "/**\r\n * Sets or retrieves the character set used to encode the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the character set used to encode the object.\r\n */" }, "hreflang": { - "comment": "/**\r\n * Sets or retrieves the language code of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the language code of the object.\r\n */" }, "rev": { - "comment": "/**\r\n * Sets or retrieves the relationship between the object and the destination of the link.\r\n */" + "comment": "/**\r\n * Sets or retrieves the relationship between the object and the destination of the link.\r\n */" }, "shape": { - "comment": "/**\r\n * Sets or retrieves the shape of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the shape of the object.\r\n */" }, "text": { - "comment": "/**\r\n * Retrieves or sets the text of the object as a string.\r\n */" + "comment": "/**\r\n * Retrieves or sets the text of the object as a string.\r\n */" } } } @@ -1251,16 +1251,16 @@ "properties": { "property": { "value": { - "comment": "/**\r\n * Sets or retrieves the value of an input parameter for an element.\r\n */" + "comment": "/**\r\n * Sets or retrieves the value of an input parameter for an element.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of an input parameter for an element.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of an input parameter for an element.\r\n */" }, "type": { - "comment": "/**\r\n * Sets or retrieves the content type of the resource designated by the value attribute.\r\n */" + "comment": "/**\r\n * Sets or retrieves the content type of the resource designated by the value attribute.\r\n */" }, "valueType": { - "comment": "/**\r\n * Sets or retrieves the data type of the value attribute.\r\n */" + "comment": "/**\r\n * Sets or retrieves the data type of the value attribute.\r\n */" } } } @@ -1269,7 +1269,7 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or gets a value that you can use to implement your own width functionality for the object.\r\n */" + "comment": "/**\r\n * Sets or gets a value that you can use to implement your own width functionality for the object.\r\n */" } } } @@ -1278,20 +1278,20 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Gets or sets the width of a canvas element on a document.\r\n */" + "comment": "/**\r\n * Gets or sets the width of a canvas element on a document.\r\n */" }, "height": { - "comment": "/**\r\n * Gets or sets the height of a canvas element on a document.\r\n */" + "comment": "/**\r\n * Gets or sets the height of a canvas element on a document.\r\n */" } } }, "methods": { "method": { "toDataURL": { - "comment": "/**\r\n * Returns the content of the current canvas as an image that you can use as a source for another canvas or an HTML element.\r\n * @param type The standard MIME type for the image format to return. If you do not specify this parameter, the default value is a PNG format image.\r\n */" + "comment": "/**\r\n * Returns the content of the current canvas as an image that you can use as a source for another canvas or an HTML element.\r\n * @param type The standard MIME type for the image format to return. If you do not specify this parameter, the default value is a PNG format image.\r\n */" }, "getContext": { - "comment": "/**\r\n * Returns an object that provides methods and properties for drawing and manipulating images and graphics on a canvas element in a document. A context object includes information about colors, line widths, fonts, and other graphic parameters that can be drawn on a canvas.\r\n * @param contextId The identifier (ID) of the type of canvas to create. Internet Explorer 9 and Internet Explorer 10 support only a 2-D context using canvas.getContext(\"2d\"); IE11 Preview also supports 3-D or WebGL context using canvas.getContext(\"experimental-webgl\");\r\n */" + "comment": "/**\r\n * Returns an object that provides methods and properties for drawing and manipulating images and graphics on a canvas element in a document. A context object includes information about colors, line widths, fonts, and other graphic parameters that can be drawn on a canvas.\r\n * @param contextId The identifier (ID) of the type of canvas to create. Internet Explorer 9 and Internet Explorer 10 support only a 2-D context using canvas.getContext(\"2d\"); IE11 Preview also supports 3-D or WebGL context using canvas.getContext(\"experimental-webgl\");\r\n */" } } } @@ -1300,7 +1300,7 @@ "properties": { "property": { "text": { - "comment": "/**\r\n * Retrieves or sets the text of the object as a string.\r\n */" + "comment": "/**\r\n * Retrieves or sets the text of the object as a string.\r\n */" } } } @@ -1309,10 +1309,10 @@ "properties": { "property": { "media": { - "comment": "/**\r\n * Sets or retrieves the media type.\r\n */" + "comment": "/**\r\n * Sets or retrieves the media type.\r\n */" }, "type": { - "comment": "/**\r\n * Retrieves the CSS language in which the style sheet is written.\r\n */" + "comment": "/**\r\n * Retrieves the CSS language in which the style sheet is written.\r\n */" } } } @@ -1321,37 +1321,37 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "headers": { - "comment": "/**\r\n * Sets or retrieves a list of header cells that provide information for the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a list of header cells that provide information for the object.\r\n */" }, "cellIndex": { - "comment": "/**\r\n * Retrieves the position of the object in the cells collection of a row.\r\n */" + "comment": "/**\r\n * Retrieves the position of the object in the cells collection of a row.\r\n */" }, "align": { - "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" + "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" }, "colSpan": { - "comment": "/**\r\n * Sets or retrieves the number columns in the table that the object should span.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number columns in the table that the object should span.\r\n */" }, "axis": { - "comment": "/**\r\n * Sets or retrieves a comma-delimited list of conceptual categories associated with the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a comma-delimited list of conceptual categories associated with the object.\r\n */" }, "height": { - "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" }, "noWrap": { - "comment": "/**\r\n * Sets or retrieves whether the browser automatically performs wordwrap.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether the browser automatically performs wordwrap.\r\n */" }, "abbr": { - "comment": "/**\r\n * Sets or retrieves abbreviated text for the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves abbreviated text for the object.\r\n */" }, "rowSpan": { - "comment": "/**\r\n * Sets or retrieves how many rows in a table the cell should span.\r\n */" + "comment": "/**\r\n * Sets or retrieves how many rows in a table the cell should span.\r\n */" }, "scope": { - "comment": "/**\r\n * Sets or retrieves the group of cells in a table to which the object's information applies.\r\n */" + "comment": "/**\r\n * Sets or retrieves the group of cells in a table to which the object's information applies.\r\n */" } } } @@ -1360,10 +1360,10 @@ "properties": { "property": { "face": { - "comment": "/**\r\n * Sets or retrieves the current typeface family.\r\n */" + "comment": "/**\r\n * Sets or retrieves the current typeface family.\r\n */" }, "size": { - "comment": "/**\r\n * Sets or retrieves the font size of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the font size of the object.\r\n */" } } } @@ -1372,74 +1372,74 @@ "properties": { "property": { "value": { - "comment": "/**\r\n * Retrieves or sets the text in the entry field of the textArea element.\r\n */" + "comment": "/**\r\n * Retrieves or sets the text in the entry field of the textArea element.\r\n */" }, "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "selectionStart": { - "comment": "/**\r\n * Gets or sets the starting position or offset of a text selection.\r\n */" + "comment": "/**\r\n * Gets or sets the starting position or offset of a text selection.\r\n */" }, "rows": { - "comment": "/**\r\n * Sets or retrieves the number of horizontal rows contained in the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number of horizontal rows contained in the object.\r\n */" }, "cols": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "readOnly": { - "comment": "/**\r\n * Sets or retrieves the value indicated whether the content of the object is read-only.\r\n */" + "comment": "/**\r\n * Sets or retrieves the value indicated whether the content of the object is read-only.\r\n */" }, "wrap": { - "comment": "/**\r\n * Sets or retrieves how to handle wordwrapping in the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves how to handle wordwrapping in the object.\r\n */" }, "selectionEnd": { - "comment": "/**\r\n * Gets or sets the end position or offset of a text selection.\r\n */" + "comment": "/**\r\n * Gets or sets the end position or offset of a text selection.\r\n */" }, "type": { - "comment": "/**\r\n * Retrieves the type of control.\r\n */" + "comment": "/**\r\n * Retrieves the type of control.\r\n */" }, "defaultValue": { - "comment": "/**\r\n * Sets or retrieves the initial contents of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the initial contents of the object.\r\n */" }, "validationMessage": { - "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" + "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" }, "autofocus": { - "comment": "/**\r\n * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing.\r\n */" + "comment": "/**\r\n * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing.\r\n */" }, "validity": { - "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" + "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" }, "required": { - "comment": "/**\r\n * When present, marks an element that can't be submitted without a value.\r\n */" + "comment": "/**\r\n * When present, marks an element that can't be submitted without a value.\r\n */" }, "maxLength": { - "comment": "/**\r\n * Sets or retrieves the maximum number of characters that the user can enter in a text control.\r\n */" + "comment": "/**\r\n * Sets or retrieves the maximum number of characters that the user can enter in a text control.\r\n */" }, "willValidate": { - "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" + "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" }, "placeholder": { - "comment": "/**\r\n * Gets or sets a text string that is displayed in an input field as a hint or prompt to users as the format or type of information they need to enter.The text appears in an input field until the user puts focus on the field.\r\n */" + "comment": "/**\r\n * Gets or sets a text string that is displayed in an input field as a hint or prompt to users as the format or type of information they need to enter.The text appears in an input field until the user puts focus on the field.\r\n */" } } }, "methods": { "method": { "setSelectionRange": { - "comment": "/**\r\n * Sets the start and end positions of a selection in a text field.\r\n * @param start The offset into the text field for the start of the selection.\r\n * @param end The offset into the text field for the end of the selection.\r\n * @param direction The direction in which the selection is performed.\r\n */" + "comment": "/**\r\n * Sets the start and end positions of a selection in a text field.\r\n * @param start The offset into the text field for the start of the selection.\r\n * @param end The offset into the text field for the end of the selection.\r\n * @param direction The direction in which the selection is performed.\r\n */" }, "select": { - "comment": "/**\r\n * Highlights the input area of a form element.\r\n */" + "comment": "/**\r\n * Highlights the input area of a form element.\r\n */" }, "checkValidity": { - "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" + "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" }, "setCustomValidity": { - "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" + "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" } } } @@ -1448,10 +1448,10 @@ "properties": { "property": { "dateTime": { - "comment": "/**\r\n * Sets or retrieves the date and time of a modification to the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the date and time of a modification to the object.\r\n */" }, "cite": { - "comment": "/**\r\n * Sets or retrieves reference information about the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves reference information about the object.\r\n */" } } } @@ -1460,13 +1460,13 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "align": { - "comment": "/**\r\n * Sets or retrieves the alignment of the object relative to the display or table.\r\n */" + "comment": "/**\r\n * Sets or retrieves the alignment of the object relative to the display or table.\r\n */" }, "span": { - "comment": "/**\r\n * Sets or retrieves the number of columns in the group.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number of columns in the group.\r\n */" } } } @@ -1475,7 +1475,7 @@ "properties": { "property": { "align": { - "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" + "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" } } } @@ -1484,7 +1484,7 @@ "properties": { "property": { "clear": { - "comment": "/**\r\n * Sets or retrieves the side on which floating objects are not to be positioned when any IHTMLBlockElement is inserted into the document.\r\n */" + "comment": "/**\r\n * Sets or retrieves the side on which floating objects are not to be positioned when any IHTMLBlockElement is inserted into the document.\r\n */" } } } @@ -1493,7 +1493,7 @@ "properties": { "property": { "align": { - "comment": "/**\r\n * Sets or retrieves a value that indicates the table alignment.\r\n */" + "comment": "/**\r\n * Sets or retrieves a value that indicates the table alignment.\r\n */" } } } @@ -1502,50 +1502,50 @@ "properties": { "property": { "length": { - "comment": "/**\r\n * Sets or retrieves the number of objects in a collection.\r\n */" + "comment": "/**\r\n * Sets or retrieves the number of objects in a collection.\r\n */" }, "target": { - "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" + "comment": "/**\r\n * Sets or retrieves the window or frame at which to target content.\r\n */" }, "acceptCharset": { - "comment": "/**\r\n * Sets or retrieves a list of character encodings for input data that must be accepted by the server processing the form.\r\n */" + "comment": "/**\r\n * Sets or retrieves a list of character encodings for input data that must be accepted by the server processing the form.\r\n */" }, "enctype": { - "comment": "/**\r\n * Sets or retrieves the encoding type for the form.\r\n */" + "comment": "/**\r\n * Sets or retrieves the encoding type for the form.\r\n */" }, "elements": { - "comment": "/**\r\n * Retrieves a collection, in source order, of all controls in a given form.\r\n */" + "comment": "/**\r\n * Retrieves a collection, in source order, of all controls in a given form.\r\n */" }, "action": { - "comment": "/**\r\n * Sets or retrieves the URL to which the form content is sent for processing.\r\n */" + "comment": "/**\r\n * Sets or retrieves the URL to which the form content is sent for processing.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "method": { - "comment": "/**\r\n * Sets or retrieves how to send the form data to the server.\r\n */" + "comment": "/**\r\n * Sets or retrieves how to send the form data to the server.\r\n */" }, "encoding": { - "comment": "/**\r\n * Sets or retrieves the MIME encoding for the form.\r\n */" + "comment": "/**\r\n * Sets or retrieves the MIME encoding for the form.\r\n */" }, "autocomplete": { - "comment": "/**\r\n * Specifies whether autocomplete is applied to an editable text field.\r\n */" + "comment": "/**\r\n * Specifies whether autocomplete is applied to an editable text field.\r\n */" }, "noValidate": { - "comment": "/**\r\n * Designates a form that is not validated when submitted.\r\n */" + "comment": "/**\r\n * Designates a form that is not validated when submitted.\r\n */" } } }, "methods": { "method": { "reset": { - "comment": "/**\r\n * Fires when the user resets a form.\r\n */" + "comment": "/**\r\n * Fires when the user resets a form.\r\n */" }, "submit": { - "comment": "/**\r\n * Fires when a FORM is about to be submitted.\r\n */" + "comment": "/**\r\n * Fires when a FORM is about to be submitted.\r\n */" }, "checkValidity": { - "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" + "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" } } } @@ -1554,116 +1554,116 @@ "properties": { "property": { "played": { - "comment": "/**\r\n * Gets TimeRanges for the current media resource that has been played.\r\n */" + "comment": "/**\r\n * Gets TimeRanges for the current media resource that has been played.\r\n */" }, "currentSrc": { - "comment": "/**\r\n * Gets the address or URL of the current media resource that is selected by IHTMLMediaElement.\r\n */" + "comment": "/**\r\n * Gets the address or URL of the current media resource that is selected by IHTMLMediaElement.\r\n */" }, "loop": { - "comment": "/**\r\n * Gets or sets a flag to specify whether playback should restart after it completes.\r\n */" + "comment": "/**\r\n * Gets or sets a flag to specify whether playback should restart after it completes.\r\n */" }, "ended": { - "comment": "/**\r\n * Gets information about whether the playback has ended or not.\r\n */" + "comment": "/**\r\n * Gets information about whether the playback has ended or not.\r\n */" }, "buffered": { - "comment": "/**\r\n * Gets a collection of buffered time ranges.\r\n */" + "comment": "/**\r\n * Gets a collection of buffered time ranges.\r\n */" }, "error": { - "comment": "/**\r\n * Returns an object representing the current error state of the audio or video element.\r\n */" + "comment": "/**\r\n * Returns an object representing the current error state of the audio or video element.\r\n */" }, "seekable": { - "comment": "/**\r\n * Returns a TimeRanges object that represents the ranges of the current media resource that can be seeked.\r\n */" + "comment": "/**\r\n * Returns a TimeRanges object that represents the ranges of the current media resource that can be seeked.\r\n */" }, "autoplay": { - "comment": "/**\r\n * Gets or sets a value that indicates whether to start playing the media automatically.\r\n */" + "comment": "/**\r\n * Gets or sets a value that indicates whether to start playing the media automatically.\r\n */" }, "controls": { - "comment": "/**\r\n * Gets or sets a flag that indicates whether the client provides a set of controls for the media (in case the developer does not include controls for the player).\r\n */" + "comment": "/**\r\n * Gets or sets a flag that indicates whether the client provides a set of controls for the media (in case the developer does not include controls for the player).\r\n */" }, "volume": { - "comment": "/**\r\n * Gets or sets the volume level for audio portions of the media element.\r\n */" + "comment": "/**\r\n * Gets or sets the volume level for audio portions of the media element.\r\n */" }, "src": { - "comment": "/**\r\n * The address or URL of the a media resource that is to be considered.\r\n */" + "comment": "/**\r\n * The address or URL of the a media resource that is to be considered.\r\n */" }, "playbackRate": { - "comment": "/**\r\n * Gets or sets the current rate of speed for the media resource to play. This speed is expressed as a multiple of the normal speed of the media resource.\r\n */" + "comment": "/**\r\n * Gets or sets the current rate of speed for the media resource to play. This speed is expressed as a multiple of the normal speed of the media resource.\r\n */" }, "duration": { - "comment": "/**\r\n * Returns the duration in seconds of the current media resource. A NaN value is returned if duration is not available, or Infinity if the media resource is streaming.\r\n */" + "comment": "/**\r\n * Returns the duration in seconds of the current media resource. A NaN value is returned if duration is not available, or Infinity if the media resource is streaming.\r\n */" }, "muted": { - "comment": "/**\r\n * Gets or sets a flag that indicates whether the audio (either audio or the audio track on video media) is muted.\r\n */" + "comment": "/**\r\n * Gets or sets a flag that indicates whether the audio (either audio or the audio track on video media) is muted.\r\n */" }, "defaultPlaybackRate": { - "comment": "/**\r\n * Gets or sets the default playback rate when the user is not using fast forward or reverse for a video or audio resource.\r\n */" + "comment": "/**\r\n * Gets or sets the default playback rate when the user is not using fast forward or reverse for a video or audio resource.\r\n */" }, "paused": { - "comment": "/**\r\n * Gets a flag that specifies whether playback is paused.\r\n */" + "comment": "/**\r\n * Gets a flag that specifies whether playback is paused.\r\n */" }, "seeking": { - "comment": "/**\r\n * Gets a flag that indicates whether the the client is currently moving to a new playback position in the media resource.\r\n */" + "comment": "/**\r\n * Gets a flag that indicates whether the the client is currently moving to a new playback position in the media resource.\r\n */" }, "currentTime": { - "comment": "/**\r\n * Gets or sets the current playback position, in seconds.\r\n */" + "comment": "/**\r\n * Gets or sets the current playback position, in seconds.\r\n */" }, "preload": { - "comment": "/**\r\n * Gets or sets the current playback position, in seconds.\r\n */" + "comment": "/**\r\n * Gets or sets the current playback position, in seconds.\r\n */" }, "networkState": { - "comment": "/**\r\n * Gets the current network activity for the element.\r\n */" + "comment": "/**\r\n * Gets the current network activity for the element.\r\n */" }, "msAudioCategory": { - "comment": "/**\r\n * Specifies the purpose of the audio or video media, such as background audio or alerts.\r\n */" + "comment": "/**\r\n * Specifies the purpose of the audio or video media, such as background audio or alerts.\r\n */" }, "msRealTime": { - "comment": "/**\r\n * Specifies whether or not to enable low-latency playback on the media element.\r\n */" + "comment": "/**\r\n * Specifies whether or not to enable low-latency playback on the media element.\r\n */" }, "msPlayToPrimary": { - "comment": "/**\r\n * Gets or sets the primary DLNA PlayTo device.\r\n */" + "comment": "/**\r\n * Gets or sets the primary DLNA PlayTo device.\r\n */" }, "msPlayToDisabled": { - "comment": "/**\r\n * Gets or sets whether the DLNA PlayTo device is available.\r\n */" + "comment": "/**\r\n * Gets or sets whether the DLNA PlayTo device is available.\r\n */" }, "audioTracks": { - "comment": "/**\r\n * Returns an AudioTrackList object with the audio tracks for a given video element.\r\n */" + "comment": "/**\r\n * Returns an AudioTrackList object with the audio tracks for a given video element.\r\n */" }, "msPlayToSource": { - "comment": "/**\r\n * Gets the source associated with the media element for use by the PlayToManager.\r\n */" + "comment": "/**\r\n * Gets the source associated with the media element for use by the PlayToManager.\r\n */" }, "msAudioDeviceType": { - "comment": "/**\r\n * Specifies the output device id that the audio will be sent to.\r\n */" + "comment": "/**\r\n * Specifies the output device id that the audio will be sent to.\r\n */" }, "msPlayToPreferredSourceUri": { - "comment": "/**\r\n * Gets or sets the path to the preferred media source. This enables the Play To target device to stream the media content, which can be DRM protected, from a different location, such as a cloud media server.\r\n */" + "comment": "/**\r\n * Gets or sets the path to the preferred media source. This enables the Play To target device to stream the media content, which can be DRM protected, from a different location, such as a cloud media server.\r\n */" }, "msKeys": { - "comment": "/**\r\n * Gets the MSMediaKeys object, which is used for decrypting media data, that is associated with this media element.\r\n */" + "comment": "/**\r\n * Gets the MSMediaKeys object, which is used for decrypting media data, that is associated with this media element.\r\n */" } } }, "methods": { "method": { "pause": { - "comment": "/**\r\n * Pauses the current playback and sets paused to TRUE. This can be used to test whether the media is playing or paused. You can also use the pause or play events to tell whether the media is playing or not.\r\n */" + "comment": "/**\r\n * Pauses the current playback and sets paused to TRUE. This can be used to test whether the media is playing or paused. You can also use the pause or play events to tell whether the media is playing or not.\r\n */" }, "play": { - "comment": "/**\r\n * Loads and starts playback of a media resource.\r\n */" + "comment": "/**\r\n * Loads and starts playback of a media resource.\r\n */" }, "load": { - "comment": "/**\r\n * Resets the audio or video object and loads a new media resource.\r\n */" + "comment": "/**\r\n * Resets the audio or video object and loads a new media resource.\r\n */" }, "canPlayType": { - "comment": "/**\r\n * Returns a string that specifies whether the client can play a given media resource type.\r\n */" + "comment": "/**\r\n * Returns a string that specifies whether the client can play a given media resource type.\r\n */" }, "msClearEffects": { - "comment": "/**\r\n * Clears all effects from the media pipeline.\r\n */" + "comment": "/**\r\n * Clears all effects from the media pipeline.\r\n */" }, "msSetMediaProtectionManager": { - "comment": "/**\r\n * Specifies the media protection manager for a given media pipeline.\r\n */" + "comment": "/**\r\n * Specifies the media protection manager for a given media pipeline.\r\n */" }, "msInsertAudioEffect": { - "comment": "/**\r\n * Inserts the specified audio effect into media pipeline.\r\n */" + "comment": "/**\r\n * Inserts the specified audio effect into media pipeline.\r\n */" } } } @@ -1672,26 +1672,26 @@ "properties": { "property": { "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" }, "validationMessage": { - "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" + "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" }, "validity": { - "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" + "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" }, "willValidate": { - "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" + "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" } } }, "methods": { "method": { "checkValidity": { - "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" + "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" }, "setCustomValidity": { - "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" + "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" } } } @@ -1700,13 +1700,13 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "align": { - "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" + "comment": "/**\r\n * Sets or retrieves how the object is aligned with adjacent text.\r\n */" }, "noShade": { - "comment": "/**\r\n * Sets or retrieves whether the horizontal rule is drawn with 3-D shading.\r\n */" + "comment": "/**\r\n * Sets or retrieves whether the horizontal rule is drawn with 3-D shading.\r\n */" } } } @@ -1715,77 +1715,77 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "codeType": { - "comment": "/**\r\n * Sets or retrieves the Internet media type for the code associated with the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the Internet media type for the code associated with the object.\r\n */" }, "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" }, "code": { - "comment": "/**\r\n * Sets or retrieves the URL of the file containing the compiled Java class.\r\n */" + "comment": "/**\r\n * Sets or retrieves the URL of the file containing the compiled Java class.\r\n */" }, "archive": { - "comment": "/**\r\n * Sets or retrieves a character string that can be used to implement your own archive functionality for the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a character string that can be used to implement your own archive functionality for the object.\r\n */" }, "standby": { - "comment": "/**\r\n * Sets or retrieves a message to be displayed while an object is loading.\r\n */" + "comment": "/**\r\n * Sets or retrieves a message to be displayed while an object is loading.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "useMap": { - "comment": "/**\r\n * Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.\r\n */" + "comment": "/**\r\n * Sets or retrieves the URL, often with a bookmark extension (#name), to use as a client-side image map.\r\n */" }, "data": { - "comment": "/**\r\n * Sets or retrieves the URL that references the data of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the URL that references the data of the object.\r\n */" }, "height": { - "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" }, "contentDocument": { - "comment": "/**\r\n * Retrieves the document object of the page or frame.\r\n */" + "comment": "/**\r\n * Retrieves the document object of the page or frame.\r\n */" }, "codeBase": { - "comment": "/**\r\n * Sets or retrieves the URL of the component.\r\n */" + "comment": "/**\r\n * Sets or retrieves the URL of the component.\r\n */" }, "type": { - "comment": "/**\r\n * Sets or retrieves the MIME type of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the MIME type of the object.\r\n */" }, "BaseHref": { - "comment": "/**\r\n * Retrieves a string of the URL where the object tag can be found. This is often the href of the document that the object is in, or the value set by a base element.\r\n */" + "comment": "/**\r\n * Retrieves a string of the URL where the object tag can be found. This is often the href of the document that the object is in, or the value set by a base element.\r\n */" }, "validationMessage": { - "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" + "comment": "/**\r\n * Returns the error message that would be displayed if the user submits the form, or an empty string if no error message. It also triggers the standard error message, such as \"this is a required field\". The result is that the user sees validation messages without actually submitting.\r\n */" }, "validity": { - "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" + "comment": "/**\r\n * Returns a ValidityState object that represents the validity states of an element.\r\n */" }, "willValidate": { - "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" + "comment": "/**\r\n * Returns whether an element will successfully validate based on forms validation rules and constraints.\r\n */" }, "msPlayToPreferredSourceUri": { - "comment": "/**\r\n * Gets or sets the path to the preferred media source. This enables the Play To target device to stream the media content, which can be DRM protected, from a different location, such as a cloud media server.\r\n */" + "comment": "/**\r\n * Gets or sets the path to the preferred media source. This enables the Play To target device to stream the media content, which can be DRM protected, from a different location, such as a cloud media server.\r\n */" }, "msPlayToPrimary": { - "comment": "/**\r\n * Gets or sets the primary DLNA PlayTo device.\r\n */" + "comment": "/**\r\n * Gets or sets the primary DLNA PlayTo device.\r\n */" }, "msPlayToDisabled": { - "comment": "/**\r\n * Gets or sets whether the DLNA PlayTo device is available.\r\n */" + "comment": "/**\r\n * Gets or sets whether the DLNA PlayTo device is available.\r\n */" }, "msPlayToSource": { - "comment": "/**\r\n * Gets the source associated with the media element for use by the PlayToManager.\r\n */" + "comment": "/**\r\n * Gets the source associated with the media element for use by the PlayToManager.\r\n */" } } }, "methods": { "method": { "checkValidity": { - "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" + "comment": "/**\r\n * Returns whether a form will validate when it is submitted, without having to submit it.\r\n */" }, "setCustomValidity": { - "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" + "comment": "/**\r\n * Sets a custom error message that is displayed when a form is submitted.\r\n * @param error Sets a custom error message that is displayed when a form is submitted.\r\n */" } } } @@ -1794,37 +1794,37 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the width of the object.\r\n */" }, "palette": { - "comment": "/**\r\n * Retrieves the palette used for the embedded document.\r\n */" + "comment": "/**\r\n * Retrieves the palette used for the embedded document.\r\n */" }, "src": { - "comment": "/**\r\n * Sets or retrieves a URL to be loaded by the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a URL to be loaded by the object.\r\n */" }, "name": { - "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the name of the object.\r\n */" }, "pluginspage": { - "comment": "/**\r\n * Retrieves the URL of the plug-in used to view an embedded document.\r\n */" + "comment": "/**\r\n * Retrieves the URL of the plug-in used to view an embedded document.\r\n */" }, "height": { - "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the height of the object.\r\n */" }, "units": { - "comment": "/**\r\n * Sets or retrieves the height and width units of the embed object.\r\n */" + "comment": "/**\r\n * Sets or retrieves the height and width units of the embed object.\r\n */" }, "msPlayToPreferredSourceUri": { - "comment": "/**\r\n * Gets or sets the path to the preferred media source. This enables the Play To target device to stream the media content, which can be DRM protected, from a different location, such as a cloud media server.\r\n */" + "comment": "/**\r\n * Gets or sets the path to the preferred media source. This enables the Play To target device to stream the media content, which can be DRM protected, from a different location, such as a cloud media server.\r\n */" }, "msPlayToPrimary": { - "comment": "/**\r\n * Gets or sets the primary DLNA PlayTo device.\r\n */" + "comment": "/**\r\n * Gets or sets the primary DLNA PlayTo device.\r\n */" }, "msPlayToDisabled": { - "comment": "/**\r\n * Gets or sets whether the DLNA PlayTo device is available.\r\n */" + "comment": "/**\r\n * Gets or sets whether the DLNA PlayTo device is available.\r\n */" }, "msPlayToSource": { - "comment": "/**\r\n * Gets the source associated with the media element for use by the PlayToManager.\r\n */" + "comment": "/**\r\n * Gets the source associated with the media element for use by the PlayToManager.\r\n */" } } } @@ -1833,10 +1833,10 @@ "properties": { "property": { "form": { - "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" + "comment": "/**\r\n * Retrieves a reference to the form that the object is embedded in.\r\n */" }, "label": { - "comment": "/**\r\n * Sets or retrieves a value that you can use to implement your own label functionality for the object.\r\n */" + "comment": "/**\r\n * Sets or retrieves a value that you can use to implement your own label functionality for the object.\r\n */" } } } @@ -1845,19 +1845,19 @@ "properties": { "property": { "width": { - "comment": "/**\r\n * Gets or sets the width of the video element.\r\n */" + "comment": "/**\r\n * Gets or sets the width of the video element.\r\n */" }, "videoWidth": { - "comment": "/**\r\n * Gets the intrinsic width of a video in CSS pixels, or zero if the dimensions are not known.\r\n */" + "comment": "/**\r\n * Gets the intrinsic width of a video in CSS pixels, or zero if the dimensions are not known.\r\n */" }, "videoHeight": { - "comment": "/**\r\n * Gets the intrinsic height of a video in CSS pixels, or zero if the dimensions are not known.\r\n */" + "comment": "/**\r\n * Gets the intrinsic height of a video in CSS pixels, or zero if the dimensions are not known.\r\n */" }, "height": { - "comment": "/**\r\n * Gets or sets the height of the video element.\r\n */" + "comment": "/**\r\n * Gets or sets the height of the video element.\r\n */" }, "poster": { - "comment": "/**\r\n * Gets or sets a URL of an image to display, for example, like a movie poster. This can be a still frame from the video, or another image if no video data is available.\r\n */" + "comment": "/**\r\n * Gets or sets a URL of an image to display, for example, like a movie poster. This can be a still frame from the video, or another image if no video data is available.\r\n */" } } } @@ -1866,13 +1866,13 @@ "properties": { "property": { "value": { - "comment": "/**\r\n * Sets or gets the current value of a progress element. The value must be a non-negative number between 0 and the max value.\r\n */" + "comment": "/**\r\n * Sets or gets the current value of a progress element. The value must be a non-negative number between 0 and the max value.\r\n */" }, "max": { - "comment": "/**\r\n * Defines the maximum, or \"done\" value for a progress element.\r\n */" + "comment": "/**\r\n * Defines the maximum, or \"done\" value for a progress element.\r\n */" }, "position": { - "comment": "/**\r\n * Returns the quotient of value/max when the value attribute is set (determinate progress bar), or -1 when the value attribute is missing (indeterminate progress bar).\r\n */" + "comment": "/**\r\n * Returns the quotient of value/max when the value attribute is set (determinate progress bar), or -1 when the value attribute is missing (indeterminate progress bar).\r\n */" } } } @@ -1881,32 +1881,32 @@ "methods": { "method": { "append": { - "comment": "/**\r\n * Appends a specified key/value pair as a new search parameter.\r\n */" + "comment": "/**\r\n * Appends a specified key/value pair as a new search parameter.\r\n */" }, "delete": { - "comment": "/**\r\n * Deletes the given search parameter, and its associated value, from the list of all search parameters.\r\n */" + "comment": "/**\r\n * Deletes the given search parameter, and its associated value, from the list of all search parameters.\r\n */" }, "get": { - "comment": "/**\r\n * Returns the first value associated to the given search parameter.\r\n */" + "comment": "/**\r\n * Returns the first value associated to the given search parameter.\r\n */" }, "getAll": { - "comment": "/**\r\n * Returns all the values association with a given search parameter.\r\n */" + "comment": "/**\r\n * Returns all the values association with a given search parameter.\r\n */" }, "has": { - "comment": "/**\r\n * Returns a Boolean indicating if such a search parameter exists.\r\n */" + "comment": "/**\r\n * Returns a Boolean indicating if such a search parameter exists.\r\n */" }, "set": { - "comment": "/**\r\n * Sets the value associated to a given search parameter to the given value. If there were several values, delete the others.\r\n */" + "comment": "/**\r\n * Sets the value associated to a given search parameter to the given value. If there were several values, delete the others.\r\n */" } }, - "constructor": "/**\r\n * Constructor returning a URLSearchParams object.\r\n */" + "constructor": "/**\r\n * Constructor returning a URLSearchParams object.\r\n */" }, "iterator": { "comments": { "comment": { - "entries": "/**\r\n * Returns an array of key, value pairs for every entry in the search params.\r\n */", - "keys": "/**\r\n * Returns a list of keys in the search params.\r\n */", - "values": "/**\r\n * Returns a list of values in the search params.\r\n */" + "entries": "/**\r\n * Returns an array of key, value pairs for every entry in the search params.\r\n */", + "keys": "/**\r\n * Returns a list of keys in the search params.\r\n */", + "values": "/**\r\n * Returns a list of values in the search params.\r\n */" } } }