2eb4f27674
Currently, there are a few linting functions that only run on certain filetypes (determined by the file extension). Prior to this commit, the special cases were handled in a parent function with a conditional. This commit changes the system so each linting function gets passed a filename so the function can determine whether it should run or not based on the file extension. I also refactored flake8 linting slightly. From what I've read so far of the code, flake8 itself will only print the results directly to stdout (though the linter would report the quantity of errors detected). Prior to this commit, we would let flake8 print directly to stdout and just determine if there were >0 errors reported. This commit (sort of hackily) temporarily captures stdout when we call flake8 so we can do what we want with the output, allowing us to `yield` the line number and message like we do with the other linting functions. In my opinion, both of these changes isolate specific behaviors/checks into their respective linting functions instead of having them handled at a more global level. In addition to the changes above: * The whitespace linter now runs on WebIDL and TOML files * The license header linter now runs on WebIDL files Source-Repo: https://github.com/servo/servo Source-Revision: 7c8922c0c39616559b580b4a363ebe2a8c6b3ba8
155 lines
5.6 KiB
Plaintext
155 lines
5.6 KiB
Plaintext
/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
/* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
/*
|
|
* The origin of this IDL file is:
|
|
* https://dom.spec.whatwg.org/#interface-document
|
|
* https://www.whatwg.org/specs/web-apps/current-work/#the-document-object
|
|
*/
|
|
|
|
// https://dom.spec.whatwg.org/#interface-document
|
|
[Constructor]
|
|
interface Document : Node {
|
|
[SameObject]
|
|
readonly attribute DOMImplementation implementation;
|
|
readonly attribute DOMString URL;
|
|
readonly attribute Element? activeElement;
|
|
readonly attribute DOMString documentURI;
|
|
readonly attribute DOMString compatMode;
|
|
readonly attribute DOMString characterSet;
|
|
readonly attribute DOMString inputEncoding; // legacy alias of .characterSet
|
|
readonly attribute DOMString contentType;
|
|
|
|
readonly attribute DocumentType? doctype;
|
|
readonly attribute Element? documentElement;
|
|
HTMLCollection getElementsByTagName(DOMString localName);
|
|
HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
|
|
HTMLCollection getElementsByClassName(DOMString classNames);
|
|
Element? getElementById(DOMString elementId);
|
|
|
|
[NewObject, Throws]
|
|
Element createElement(DOMString localName);
|
|
[NewObject, Throws]
|
|
Element createElementNS(DOMString? namespace, DOMString qualifiedName);
|
|
[NewObject]
|
|
DocumentFragment createDocumentFragment();
|
|
[NewObject]
|
|
Text createTextNode(DOMString data);
|
|
[NewObject]
|
|
Comment createComment(DOMString data);
|
|
[NewObject, Throws]
|
|
ProcessingInstruction createProcessingInstruction(DOMString target, DOMString data);
|
|
|
|
[NewObject, Throws]
|
|
Node importNode(Node node, optional boolean deep = false);
|
|
[Throws]
|
|
Node adoptNode(Node node);
|
|
|
|
[NewObject, Throws]
|
|
Attr createAttribute(DOMString localName);
|
|
[NewObject, Throws]
|
|
Attr createAttributeNS(DOMString? namespace, DOMString localName);
|
|
|
|
[NewObject, Throws]
|
|
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);
|
|
};
|
|
Document implements ParentNode;
|
|
|
|
enum DocumentReadyState { "loading", "interactive", "complete" };
|
|
|
|
// https://www.whatwg.org/specs/web-apps/current-work/#the-document-object
|
|
// [OverrideBuiltins]
|
|
partial /*sealed*/ interface Document {
|
|
// resource metadata management
|
|
// [PutForwards=href, Unforgeable]
|
|
readonly attribute Location/*?*/ location;
|
|
// attribute DOMString domain;
|
|
// readonly attribute DOMString referrer;
|
|
[Throws]
|
|
attribute DOMString cookie;
|
|
readonly attribute DOMString lastModified;
|
|
readonly attribute DocumentReadyState readyState;
|
|
|
|
// DOM tree accessors
|
|
getter object (DOMString name);
|
|
attribute DOMString title;
|
|
[SetterThrows]
|
|
attribute HTMLElement? body;
|
|
readonly attribute HTMLHeadElement? head;
|
|
[SameObject]
|
|
readonly attribute HTMLCollection images;
|
|
[SameObject]
|
|
readonly attribute HTMLCollection embeds;
|
|
[SameObject]
|
|
readonly attribute HTMLCollection plugins;
|
|
[SameObject]
|
|
readonly attribute HTMLCollection links;
|
|
[SameObject]
|
|
readonly attribute HTMLCollection forms;
|
|
[SameObject]
|
|
readonly attribute HTMLCollection scripts;
|
|
NodeList getElementsByName(DOMString elementName);
|
|
// NodeList getItems(optional DOMString typeNames = ""); // microdata
|
|
// [SameObject]
|
|
// readonly attribute DOMElementMap cssElementMap;
|
|
readonly attribute HTMLScriptElement? currentScript;
|
|
|
|
// dynamic markup insertion
|
|
// Document open(optional DOMString type = "text/html", optional DOMString replace = "");
|
|
// WindowProxy open(DOMString url, DOMString name, DOMString features, optional boolean replace = false);
|
|
// void close();
|
|
// void write(DOMString... text);
|
|
// void writeln(DOMString... text);
|
|
|
|
// user interaction
|
|
readonly attribute Window/*Proxy?*/ defaultView;
|
|
// readonly attribute Element? activeElement;
|
|
// boolean hasFocus();
|
|
// attribute DOMString designMode;
|
|
// boolean execCommand(DOMString commandId, optional boolean showUI = false, optional DOMString value = "");
|
|
// boolean queryCommandEnabled(DOMString commandId);
|
|
// boolean queryCommandIndeterm(DOMString commandId);
|
|
// boolean queryCommandState(DOMString commandId);
|
|
// boolean queryCommandSupported(DOMString commandId);
|
|
// DOMString queryCommandValue(DOMString commandId);
|
|
// readonly attribute HTMLCollection commands;
|
|
|
|
// special event handler IDL attributes that only apply to Document objects
|
|
[LenientThis] attribute EventHandler onreadystatechange;
|
|
|
|
// also has obsolete members
|
|
};
|
|
Document implements GlobalEventHandlers;
|
|
|
|
// https://html.spec.whatwg.org/#Document-partial
|
|
partial interface Document {
|
|
// [TreatNullAs=EmptyString] attribute DOMString fgColor;
|
|
// [TreatNullAs=EmptyString] attribute DOMString linkColor;
|
|
// [TreatNullAs=EmptyString] attribute DOMString vlinkColor;
|
|
// [TreatNullAs=EmptyString] attribute DOMString alinkColor;
|
|
[TreatNullAs=EmptyString] attribute DOMString bgColor;
|
|
|
|
[SameObject]
|
|
readonly attribute HTMLCollection anchors;
|
|
[SameObject]
|
|
readonly attribute HTMLCollection applets;
|
|
|
|
// void clear();
|
|
// void captureEvents();
|
|
// void releaseEvents();
|
|
|
|
// readonly attribute HTMLAllCollection all;
|
|
};
|