google-closure-compiler 20250412.0.0-nightly → 20250413.0.0

package/externs/browser/url.js

@@ -0,0 +1,202 @@
+/*
+ * Copyright 2015 The Closure Compiler Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Definitions for URL and URLSearchParams from the spec at
+ * https://url.spec.whatwg.org.
+ *
+ * @externs
+ * @author rdcronin@google.com (Devlin Cronin)
+ */
+
+/**
+ * @typedef {Array<string>}
+ */
+var URLSearchParamsTupleType;
+
+/**
+ * Represents the query string of a URL.
+ *
+ * * When `init` is a string, it is basically parsed as a query string
+ *   `'name1=value1&name2=value2'`.
+ *
+ * * When `init` is an array of arrays of string
+ *   `([['name1', 'value1'], ['name2', 'value2']])`,
+ *   it must contain pairs of strings, where the first item in the pair will be
+ *   interpreted as a key and the second as a value.
+ *
+ *   NOTE: The specification uses Iterable rather than Array, but this is not
+ *   supported in Edge 17 - 18.
+ *
+ * * When `init` is an object, keys and values will be interpreted as such
+ *   `({name1: 'value1', name2: 'value2'}).
+ *
+ * @see https://url.spec.whatwg.org/#interface-urlsearchparams
+ * @constructor
+ * @implements {Iterable<!Array<string>>}
+ * @param {(string|!Array<!URLSearchParamsTupleType>|!Object<string,string>)=}
+ *     init
+ */
+function URLSearchParams(init) {}
+
+/**
+ * @param {string} name
+ * @param {string} value
+ * @return {undefined}
+ */
+URLSearchParams.prototype.append = function(name, value) {};
+
+/**
+ * @param {string} name
+ * @return {undefined}
+ */
+URLSearchParams.prototype.delete = function(name) {};
+
+/**
+ * @return {!IteratorIterable<!Array<string>>}
+ * @nosideeffects
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/URLSearchParams/entries
+ */
+URLSearchParams.prototype.entries = function() {};
+
+/**
+ * @param {function(string, string)} callback
+ * @return {undefined}
+ */
+URLSearchParams.prototype.forEach = function(callback) {};
+
+/**
+ * @param {string} name
+ * @return {?string}
+ */
+URLSearchParams.prototype.get = function(name) {};
+
+/**
+ * @param {string} name
+ * @return {!Array<string>}
+ */
+URLSearchParams.prototype.getAll = function(name) {};
+
+/**
+ * @param {string} name
+ * @return {boolean}
+ */
+URLSearchParams.prototype.has = function(name) {};
+
+/**
+ * @return {!IteratorIterable<string>}
+ */
+URLSearchParams.prototype.keys = function() {};
+
+
+/**
+ * @param {string} name
+ * @param {string} value
+ * @return {undefined}
+ */
+URLSearchParams.prototype.set = function(name, value) {};
+
+/**
+ * @return {undefined}
+ */
+URLSearchParams.prototype.sort = function() {};
+
+/**
+ * @return {!IteratorIterable<string>}
+ */
+URLSearchParams.prototype.values = function() {};
+
+/**
+ * @see https://url.spec.whatwg.org
+ * @constructor
+ * @param {!URL|string} url
+ * @param {(!URL|string)=} base
+ */
+function URL(url, base) {}
+
+/** @type {string} */
+URL.prototype.href;
+
+/**
+ * @const {string}
+ */
+URL.prototype.origin;
+
+/** @type {string} */
+URL.prototype.protocol;
+
+/** @type {string} */
+URL.prototype.username;
+
+/** @type {string} */
+URL.prototype.password;
+
+/** @type {string} */
+URL.prototype.host;
+
+/** @type {string} */
+URL.prototype.hostname;
+
+/** @type {string} */
+URL.prototype.port;
+
+/** @type {string} */
+URL.prototype.pathname;
+
+/** @type {string} */
+URL.prototype.search;
+
+/**
+ * @const {!URLSearchParams}
+ */
+URL.prototype.searchParams;
+
+/** @type {string} */
+URL.prototype.hash;
+
+/**
+ * @param {string} domain
+ * @return {string}
+ */
+URL.domainToASCII = function(domain) {};
+
+/**
+ * @param {string} domain
+ * @return {string}
+ */
+URL.domainToUnicode = function(domain) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-createObjectURL
+ * @param {!File|!Blob|!MediaSource|!MediaStream} obj
+ * @return {string}
+ */
+URL.createObjectURL = function(obj) {};
+
+/**
+ * @see https://url.spec.whatwg.org
+ * @param {!URL|string} url
+ * @param {(!URL|string)=} base
+ * @return {boolean}
+ */
+URL.canParse = function(url, base) {};
+
+/**
+ * @see http://www.w3.org/TR/FileAPI/#dfn-revokeObjectURL
+ * @param {!URL|string} url
+ * @return {undefined}
+ */
+URL.revokeObjectURL = function(url) {};

package/externs/browser/v8.js

@@ -0,0 +1,134 @@
+/*
+ * Copyright 2013 The Closure Compiler Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview This file describes the externs API for V8-specific objects.
+ * @externs
+ */
+
+
+
+/**
+ * Stack frame elements in V8.
+ * @constructor
+ */
+function CallSite() {}
+
+
+/**
+ * Runs the garbage collector, provided that you start V8 with --expose-gc or
+ * Chrome with --js-flags="--expose-gc".
+ * See https://v8.dev/docs/memory-leaks
+ * @type {undefined|function()}
+ */
+CallSite.prototype.gc;
+
+
+/**
+ * Returns the value of this.
+ * @return {Object|undefined}
+ */
+CallSite.prototype.getThis = function() {};
+
+
+/**
+ * Returns the type of this as a string. This is the name of the function stored
+ * in the constructor field of this, if available, otherwise the object's
+ * [[Class]] internal property.
+ * @return {string|undefined}
+ */
+CallSite.prototype.getTypeName = function() {};
+
+
+/**
+ * Returns the current function.
+ * @return {!Function|undefined}
+ */
+CallSite.prototype.getFunction = function() {};
+
+
+/**
+ * Returns the name of the current function, typically its name property. If a
+ * name property is not available an attempt will be made to try to infer a name
+ * from the function's context.
+ * @return {string|undefined}
+ */
+CallSite.prototype.getFunctionName = function() {};
+
+
+/**
+ * Returns the name of the property of this or one of its prototypes that holds
+ * the current function.
+ * @return {string|undefined}
+ */
+CallSite.prototype.getMethodName = function() {};
+
+
+/**
+ * If this function was defined in a script returns the name of the script
+ * @return {string|undefined}
+ */
+CallSite.prototype.getFileName = function() {};
+
+
+/**
+ * If this function was defined in a script returns the current line number.
+ * @return {number|undefined}
+ */
+CallSite.prototype.getLineNumber = function() {};
+
+
+/**
+ * If this function was defined in a script returns the current column number.
+ * @return {number|undefined}
+ */
+CallSite.prototype.getColumnNumber = function() {};
+
+
+/**
+ * If this function was created using a call to eval, returns a CallSite object
+ * representing the location where eval was called
+ * @return {CallSite|undefined}
+ */
+CallSite.prototype.getEvalOrigin = function() {};
+
+
+/**
+ * Is this a toplevel invocation, that is, is this the global object?
+ * @return {boolean}
+ */
+CallSite.prototype.isToplevel = function() {};
+
+
+/**
+ * Does this call take place in code defined by a call to eval?
+ * @return {boolean}
+ */
+CallSite.prototype.isEval = function() {};
+
+
+/**
+ * Is this call in native V8 code?
+ * @return {boolean}
+ */
+CallSite.prototype.isNative = function() {};
+
+
+/**
+ * Is this a constructor call?
+ * @return {boolean}
+ */
+CallSite.prototype.isConstructor = function() {};

package/externs/browser/w3c_abort.js

@@ -0,0 +1,89 @@
+/*
+ * Copyright 2018 The Closure Compiler Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+/**
+ * @fileoverview Definitions for AbortController
+ * @see https://dom.spec.whatwg.org/#aborting-ongoing-activities
+ * @externs
+ */
+
+
+
+/**
+ * @constructor
+ * @implements {EventTarget}
+ * @see https://dom.spec.whatwg.org/#interface-AbortSignal
+ */
+function AbortSignal() {}
+
+/** @override */
+AbortSignal.prototype.addEventListener = function(
+    type, listener, opt_options) {};
+
+/** @override */
+AbortSignal.prototype.removeEventListener = function(
+    type, listener, opt_options) {};
+
+/** @override */
+AbortSignal.prototype.dispatchEvent = function(evt) {};
+
+/**
+ * @param {*=} reason
+ * @return {!AbortSignal}
+ * @see https://dom.spec.whatwg.org/#dom-abortsignal-abort
+ */
+AbortSignal.abort = function(reason) {};
+
+/**
+ * @param {number} milliseconds
+ * @return {!AbortSignal}
+ * @see https://dom.spec.whatwg.org/#dom-abortsignal-timeout
+ */
+AbortSignal.timeout = function(milliseconds) {};
+
+/**
+ * @param {!Iterable} signals
+ * @return {!AbortSignal}
+ * @see https://dom.spec.whatwg.org/#dom-abortsignal-any
+ */
+AbortSignal.any = function(signals) {};
+
+/** @type {boolean} */
+AbortSignal.prototype.aborted;
+
+/** @type {?function(!Event)} */
+AbortSignal.prototype.onabort;
+
+/** @type {*} */
+AbortSignal.prototype.reason;
+
+/** @return {void} */
+AbortSignal.prototype.throwIfAborted = function() {};
+
+/**
+ * @constructor
+ * @see https://dom.spec.whatwg.org/#interface-abortcontroller
+ */
+function AbortController() {}
+
+/** @const {!AbortSignal} */
+AbortController.prototype.signal;
+
+/**
+ * @param {*=} reason
+ * @return {void}
+ */
+AbortController.prototype.abort = function(reason) {};

package/externs/browser/w3c_anim_timing.js

@@ -0,0 +1,49 @@
+/*
+ * Copyright 2011 The Closure Compiler Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * @fileoverview Definitions for timing control for script base animations. The
+ *  whole file has been fully type annotated.
+ *
+ * @see http://www.w3.org/TR/animation-timing/
+ * @see http://webstuff.nfshost.com/anim-timing/Overview.html
+ * @externs
+ */
+
+/**
+ * @typedef {function(number): undefined}
+ * @see https://html.spec.whatwg.org/multipage/imagebitmap-and-animations.html#framerequestcallback
+ */
+var FrameRequestCallback;
+
+/**
+ * @param {!FrameRequestCallback} callback
+ * @param {Element=} opt_element In early versions of this API, the callback
+ *     was invoked only if the element was visible.
+ * @return {number}
+ */
+function requestAnimationFrame(callback, opt_element) {};
+
+/**
+ * @param {number} handle
+ * @return {undefined}
+ */
+function cancelRequestAnimationFrame(handle) {};
+
+/**
+ * @param {number} handle
+ * @return {undefined}
+ */
+function cancelAnimationFrame(handle) {};