google-closure-compiler
Version:
Check, compile, optimize and compress Javascript with Closure-Compiler
2,037 lines • 53.5 kB
JavaScript
/*
* Copyright 2025 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 ECMAScript 6 and later.
* @see https://tc39.github.io/ecma262/
* @see https://www.khronos.org/registry/typedarray/specs/latest/
* @externs
*/
/**
* Some es6 definitions:
* Symbol, IIterableResult, Iterable, IteratorIterable, Iterator,
* IteratorIterable moved to es3 file, because some base type requires them, and
* we want to keep them together. If you add new externs related to those types
* define them together in the es3 file.
*/
/**
* TODO(b/142881197): TReturn and TNext are not yet used for anything.
* https://github.com/google/closure-compiler/issues/3489
* @interface
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Generator
* @extends {IteratorIterable<T, ?, *>}
* @template T, TReturn, TNext
*/
function Generator() {}
/**
* @param {?=} opt_value
* @return {!IIterableResult<T>}
* @override
*/
Generator.prototype.next = function(opt_value) {};
/**
* @param {T} value
* @return {!IIterableResult<T>}
*/
Generator.prototype.return = function(value) {};
/**
* @param {?} exception
* @return {!IIterableResult<T>}
*/
Generator.prototype.throw = function(exception) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.log10 = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.log2 = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.log1p = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.expm1 = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.cosh = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.sinh = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.tanh = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.acosh = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.asinh = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.atanh = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.trunc = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.sign = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
*/
Math.cbrt = function(value) {};
/**
* @param {...number} var_args
* @return {number}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/hypot
*/
Math.hypot = function(var_args) {};
/**
* @param {number} value1
* @param {number} value2
* @return {number}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/imul
*/
Math.imul = function(value1, value2) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/clz32
*/
Math.clz32 = function(value) {};
/**
* @param {number} value
* @return {number}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/fround
*/
Math.fround = function(value) {};
/**
* @param {number} x
* @return {number}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/f16round
*/
Math.f16round = function(x) {};
/**
* @param {string} string
* @return {string}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/escape
*/
RegExp.escape = function(string) {};
/**
* @param {*} a
* @param {*} b
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/is
*/
Object.is = function(a, b) {};
/**
* Returns a language-sensitive string representation of this number.
* @param {(string|!Array<string>)=} opt_locales
* @param {Object=} opt_options
* @return {string}
* @nosideeffects
* @see https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/toLocaleString
* @see http://www.ecma-international.org/ecma-402/1.0/#sec-13.2.1
* @override
*/
Number.prototype.toLocaleString = function(opt_locales, opt_options) {};
/**
* Returns the wrapped primitive value of this Number object.
* @return {number}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/valueOf
* @override
*/
Number.prototype.valueOf = function() {};
/**
* NOTE: this is an ES2022 extern.
* @param {number} index
* @return {string}
* @this {String|string}
* @nosideeffects
* @see https://tc39.github.io/ecma262/#sec-string.prototype.at
*/
String.prototype.at = function(index) {};
/**
* Pads the end of the string so that it reaches the given length.
* NOTE: this is an ES2017 (ES8) extern.
*
* @param {number} targetLength The target length.
* @param {string=} opt_padString The string to pad with.
* @this {String|string}
* @return {string}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padEnd
*/
String.prototype.padEnd = function(targetLength, opt_padString) {};
/**
* Pads the start of the string so that it reaches the given length.
* NOTE: this is an ES2017 (ES8) extern.
*
* @param {number} targetLength The target length.
* @param {string=} opt_padString The string to pad with.
* @this {String|string}
* @return {string}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padStart
*/
String.prototype.padStart = function(targetLength, opt_padString) {};
/**
* Repeats the string the given number of times.
*
* @param {number} count The number of times the string is repeated.
* @this {String|string}
* @return {string}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/repeat
*/
String.prototype.repeat = function(count) {};
/**
* @constructor
* @extends {Array<string>}
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-gettemplateobject
*/
var ITemplateArray = function() {};
/**
* @type {!Array<string>}
*/
ITemplateArray.prototype.raw;
/**
* @param {!ITemplateArray} template
* @param {...*} var_args Substitution values.
* @return {string}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/raw
*/
String.raw = function(template, var_args) {};
/**
* @param {number} codePoint
* @param {...number} var_args Additional codepoints
* @return {string}
*/
String.fromCodePoint = function(codePoint, var_args) {};
/**
* @param {number} index
* @return {number}
* @nosideeffects
*/
String.prototype.codePointAt = function(index) {};
/**
* @param {string=} opt_form
* @return {string}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/normalize
*/
String.prototype.normalize = function(opt_form) {};
/**
* @param {string} searchString
* @param {number=} opt_position
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/startsWith
*/
String.prototype.startsWith = function(searchString, opt_position) {};
/**
* @param {!RegExp|string} searchValue
* @param {?string|function(string, ...?):*} replacement
* @return {string}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replaceAll
*/
String.prototype.replaceAll = function(searchValue, replacement) {};
/**
* @param {string} searchString
* @param {number=} opt_position
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/endsWith
*/
String.prototype.endsWith = function(searchString, opt_position) {};
/**
* @param {string} searchString
* @param {number=} opt_position
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/includes
*/
String.prototype.includes = function(searchString, opt_position) {};
/**
* @this {String|string}
* @return {string}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/trimStart
*/
String.prototype.trimStart = function() {};
/**
* @this {String|string}
* @return {string}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/trimEnd
*/
String.prototype.trimEnd = function() {};
/**
* @this {String|string}
* @param {!RegExp|string} regexp
* @return {!IteratorIterable<!RegExpResult>}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/matchAll
*/
String.prototype.matchAll = function(regexp) {};
/**
* @see http://dev.w3.org/html5/postmsg/
* @interface
*/
function Transferable() {}
/**
* @param {number} length The length in bytes
* @constructor
* @throws {Error}
* @implements {Transferable}
*/
function ArrayBuffer(length) {}
/** @type {number} */
ArrayBuffer.prototype.byteLength;
/**
* @param {number} begin
* @param {number=} opt_end
* @return {!ArrayBuffer}
* @nosideeffects
*/
ArrayBuffer.prototype.slice = function(begin, opt_end) {};
/**
* @param {*} arg
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer/isView
*/
ArrayBuffer.isView = function(arg) {};
/**
* @constructor
* @template TArrayBuffer (unused)
*/
function ArrayBufferView() {}
/** @type {!ArrayBuffer} */
ArrayBufferView.prototype.buffer;
/** @type {number} */
ArrayBufferView.prototype.byteOffset;
/** @type {number} */
ArrayBufferView.prototype.byteLength;
/**
* @param {number} length The length in bytes
* @constructor
* @throws {Error}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer
*/
function SharedArrayBuffer(length) {}
/** @type {number} */
SharedArrayBuffer.prototype.byteLength;
/**
* @param {number=} begin
* @param {number=} end
* @return {!SharedArrayBuffer}
* @nosideeffects
*/
SharedArrayBuffer.prototype.slice = function(begin, end) {};
/**
* @typedef {!ArrayBuffer|!ArrayBufferView}
*/
var BufferSource;
/**
* @typedef {!ArrayBuffer|!ArrayBufferView}
*/
var AllowSharedBufferSource;
/**
* @typedef {Uint8ClampedArray}
* @deprecated CanvasPixelArray has been replaced by Uint8ClampedArray
* in the latest spec.
* @see http://www.w3.org/TR/2dcontext/#imagedata
*/
var CanvasPixelArray;
/**
* @param {ArrayBuffer|SharedArrayBuffer} buffer
* @param {number=} opt_byteOffset
* @param {number=} opt_byteLength
* @constructor
* @extends {ArrayBufferView}
* @throws {Error}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Typed_arrays/DataView
*/
function DataView(buffer, opt_byteOffset, opt_byteLength) {}
/**
* @param {number} byteOffset
* @return {number}
* @throws {Error}
*/
DataView.prototype.getInt8 = function(byteOffset) {};
/**
* @param {number} byteOffset
* @return {number}
* @throws {Error}
*/
DataView.prototype.getUint8 = function(byteOffset) {};
/**
* @param {number} byteOffset
* @param {boolean=} opt_littleEndian
* @return {number}
* @throws {Error}
*/
DataView.prototype.getInt16 = function(byteOffset, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {boolean=} opt_littleEndian
* @return {number}
* @throws {Error}
*/
DataView.prototype.getUint16 = function(byteOffset, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {boolean=} opt_littleEndian
* @return {number}
* @throws {Error}
*/
DataView.prototype.getInt32 = function(byteOffset, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {boolean=} opt_littleEndian
* @return {number}
* @throws {Error}
*/
DataView.prototype.getUint32 = function(byteOffset, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {boolean=} opt_littleEndian
* @return {number}
* @throws {Error}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView/getFloat16
*/
DataView.prototype.getFloat16 = function(byteOffset, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {boolean=} opt_littleEndian
* @return {number}
* @throws {Error}
*/
DataView.prototype.getFloat32 = function(byteOffset, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {boolean=} opt_littleEndian
* @return {number}
* @throws {Error}
*/
DataView.prototype.getFloat64 = function(byteOffset, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {boolean=} littleEndian
* @return {bigint}
* @throws {Error}
*/
DataView.prototype.getBigInt64 = function(byteOffset, littleEndian) {};
/**
* @param {number} byteOffset
* @param {boolean=} littleEndian
* @return {bigint}
* @throws {Error}
*/
DataView.prototype.getBigUint64 = function(byteOffset, littleEndian) {};
/**
* @param {number} byteOffset
* @param {number} value
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setInt8 = function(byteOffset, value) {};
/**
* @param {number} byteOffset
* @param {number} value
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setUint8 = function(byteOffset, value) {};
/**
* @param {number} byteOffset
* @param {number} value
* @param {boolean=} opt_littleEndian
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setInt16 = function(byteOffset, value, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {number} value
* @param {boolean=} opt_littleEndian
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setUint16 = function(byteOffset, value, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {number} value
* @param {boolean=} opt_littleEndian
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setInt32 = function(byteOffset, value, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {number} value
* @param {boolean=} opt_littleEndian
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setUint32 = function(byteOffset, value, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {number} value
* @param {boolean=} opt_littleEndian
* @throws {Error}
* @return {undefined}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView/setFloat16
*/
DataView.prototype.setFloat16 = function(byteOffset, value, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {number} value
* @param {boolean=} opt_littleEndian
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setFloat32 = function(
byteOffset, value, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {number} value
* @param {boolean=} opt_littleEndian
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setFloat64 = function(
byteOffset, value, opt_littleEndian) {};
/**
* @param {number} byteOffset
* @param {bigint} value
* @param {boolean=} littleEndian
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setBigInt64 = function(byteOffset, value, littleEndian) {};
/**
* @param {number} byteOffset
* @param {bigint} value
* @param {boolean=} littleEndian
* @throws {Error}
* @return {undefined}
*/
DataView.prototype.setBigUint64 = function(byteOffset, value, littleEndian) {};
/**
* @see https://github.com/promises-aplus/promises-spec
* @typedef {{then: ?}}
*/
var Thenable;
/**
* This is not an official DOM interface. It is used to add generic typing
* and respective type inference where available.
* {@see goog.Thenable} inherits from this making all promises
* interoperate.
* @record
* @struct
* @template TYPE
*/
function IThenable() {}
/**
* @param {?(function(TYPE):VALUE)=} opt_onFulfilled
* @param {?(function(*): *)=} opt_onRejected
* @return {RESULT}
* @template VALUE
*
* When a `Thenable` is fulfilled or rejected with another `Thenable`, the
* payload of the second is used as the payload of the first.
*
* @template RESULT := type('IThenable',
* cond(isUnknown(VALUE), unknown(),
* mapunion(VALUE, (V) =>
* cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
* templateTypeOf(V, 0),
* cond(sub(V, 'Thenable'),
* unknown(),
* V)))))
* =:
*/
IThenable.prototype.then = function(opt_onFulfilled, opt_onRejected) {};
/**
* NOTE: For consistency with TypeScript, prefer `PromiseLike` over `IThenable`.
* @record
* @struct
* @template TYPE
* @extends {IThenable<TYPE>}
*/
function PromiseLike() {}
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
* @param {function(
* function((TYPE|IThenable<TYPE>|Thenable|null)=),
* function(*=))} resolver
* @constructor
* @implements {PromiseLike<TYPE>}
* @template TYPE
*/
function Promise(resolver) {}
/**
* @param {VALUE=} opt_value
* @return {RESULT}
* @template VALUE
* @template RESULT := type('Promise',
* cond(isUnknown(VALUE), unknown(),
* mapunion(VALUE, (V) =>
* cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
* templateTypeOf(V, 0),
* cond(sub(V, 'Thenable'),
* unknown(),
* V)))))
* =:
*/
Promise.resolve = function(opt_value) {};
/**
* @param {function(this: null, ...*): (TYPE|!PromiseLike<TYPE>)} callbackFn
* @param {...*} var_args
* @return {!Promise<TYPE>}
* @template TYPE
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/try
*/
Promise.try = function(callbackFn, var_args) {};
/**
* @param {*=} opt_error
* @return {!Promise<?>}
*/
Promise.reject = function(opt_error) {};
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
* @param {!Iterable<VALUE>} iterable
* @return {!Promise<!Array<RESULT>>}
* @template VALUE
* @template RESULT := mapunion(VALUE, (V) =>
* cond(isUnknown(V),
* unknown(),
* cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
* templateTypeOf(V, 0),
* cond(sub(V, 'Thenable'), unknown(), V))))
* =:
*/
Promise.all = function(iterable) {};
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
* @param {!Iterable<VALUE>} iterable
* @return {!Promise<RESULT>}
* @template VALUE
* @template RESULT := mapunion(VALUE, (V) =>
* cond(isUnknown(V),
* unknown(),
* cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
* templateTypeOf(V, 0),
* cond(sub(V, 'Thenable'), unknown(), V))))
* =:
*/
Promise.any = function(iterable) {};
/**
* Record type representing a single element of the array value one gets from
* Promise.allSettled.
*
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/allSettled
* @record
* @template VALUE
*/
Promise.AllSettledResultElement = function() {};
/**
* 'fulfilled' or 'rejected' to indicate the final state of the corresponding
* Promise.
* @type {string}
*/
Promise.AllSettledResultElement.prototype.status;
/**
* Exists only if the status field is 'fulfilled'
* @type {VALUE|undefined}
*/
Promise.AllSettledResultElement.prototype.value;
/**
* Exists only if the status field is 'rejected'
* @type {*|undefined}
*/
Promise.AllSettledResultElement.prototype.reason;
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/allSettled
* @param {!Iterable<VALUE>} iterable
* @return {!Promise<!Array<!Promise.AllSettledResultElement<RESULT>>>}
* @template VALUE
* @template RESULT := mapunion(VALUE, (V) =>
* cond(isUnknown(V),
* unknown(),
* cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
* templateTypeOf(V, 0),
* cond(sub(V, 'Thenable'), unknown(), V))))
* =:
*/
Promise.allSettled = function(iterable) {};
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise
* @param {!Iterable<VALUE>} iterable
* @return {!Promise<RESULT>}
* @template VALUE
* @template RESULT := mapunion(VALUE, (V) =>
* cond(isUnknown(V),
* unknown(),
* cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
* templateTypeOf(V, 0),
* cond(sub(V, 'Thenable'), unknown(), V))))
* =:
*/
Promise.race = function(iterable) {};
/**
* Record type representing the return of Promise.withResolvers.
*
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
* @record
* @template VALUE
*/
Promise.PromiseWithResolvers = function() {};
/**
* @type {!Promise<VALUE>}
*/
Promise.PromiseWithResolvers.prototype.promise;
/**
* @type {function((VALUE|IThenable<VALUE>|Thenable)=)}
*/
Promise.PromiseWithResolvers.prototype.resolve;
/**
* @type {function(*=)}
*/
Promise.PromiseWithResolvers.prototype.reject;
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise/withResolvers
* @return {!Promise.PromiseWithResolvers<VALUE>}
* @template VALUE
*/
Promise.withResolvers = function() {};
/**
* @param {?(function(this:void, TYPE):VALUE)=} opt_onFulfilled
* @param {?(function(this:void, *): *)=} opt_onRejected
* @return {RESULT}
* @template VALUE
*
* When a `Thenable` is fulfilled or rejected with another `Thenable`, the
* payload of the second is used as the payload of the first.
*
* @template RESULT := type('Promise',
* cond(isUnknown(VALUE), unknown(),
* mapunion(VALUE, (V) =>
* cond(isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
* templateTypeOf(V, 0),
* cond(sub(V, 'Thenable'),
* unknown(),
* V)))))
* =:
* @override
*/
Promise.prototype.then = function(opt_onFulfilled, opt_onRejected) {};
/**
* @param {function(*):VALUE} onRejected
* @return {!Promise<TYPE|RESULT>} A Promise of the original type or a possibly
* a different type depending on whether the parent promise was rejected.
*
* @template VALUE
*
* When a `Thenable` is rejected with another `Thenable`, the payload of the
* second is used as the payload of the first.
*
* @template RESULT := cond(
* isUnknown(VALUE),
* unknown(),
* mapunion(VALUE, (V) =>
* cond(
* isTemplatized(V) && sub(rawTypeOf(V), 'IThenable'),
* templateTypeOf(V, 0),
* cond(
* sub(V, 'Thenable'),
* unknown(),
* V))))
* =:
*/
Promise.prototype.catch = function(onRejected) {};
/**
* @param {function()} callback
* @return {!Promise<TYPE>}
*/
Promise.prototype.finally = function(callback) {};
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/of
* @param {...T} var_args
* @return {!Array<T>}
* @template T
*/
Array.of = function(var_args) {};
/**
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/from
* @param {string|!IArrayLike<T>|!Iterable<T>} arrayLike
* @param {function(this:S, (string|T), number): R=} opt_mapFn
* @param {S=} opt_this
* @return {!Array<R>}
* @template T,S,R
*/
Array.from = function(arrayLike, opt_mapFn, opt_this) {};
/**
* @override
* @return {!IteratorIterable<number>}
*/
Array.prototype.keys;
/**
* @override
* @return {!IteratorIterable<T>}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/values
*/
Array.prototype.values;
/**
* @override
* @return {!IteratorIterable<!Array<number|T>>} Iterator of [key, value] pairs.
*/
Array.prototype.entries;
/**
* @override
* @param {function(this:S, T, number, !Array<T>): *} predicateFn
* @param {S=} opt_this
* @return {T|undefined}
* @this {IArrayLike<T>|string}
* @template T,S
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.find
*/
Array.prototype.find = function(predicateFn, opt_this) {};
/**
* @override
* @param {function(this:S, T, number, !Array<T>): *} predicateFn
* @param {S=} opt_this
* @return {number}
* @this {IArrayLike<T>|string}
* @template T,S
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.findindex
*/
Array.prototype.findIndex = function(predicateFn, opt_this) {};
/**
* NOTE: this is an ES2023 extern.
* @override
* @param {function(this:S, T, number, !Array<T>): boolean} predicateFn
* @param {S=} opt_this
* @return {T|undefined}
* @this {IArrayLike<T>|string}
* @template T,S
* @see https://tc39.es/ecma262/#sec-array.prototype.findlast
*/
Array.prototype.findLast = function(predicateFn, opt_this) {};
/**
* NOTE: this is an ES2023 extern.
* @override
* @param {function(this:S, T, number, !Array<T>): boolean} predicateFn
* @param {S=} opt_this
* @return {number}
* @this {IArrayLike<T>|string}
* @template T,S
* @see https://tc39.es/ecma262/#sec-array.prototype.findlastindex
*/
Array.prototype.findLastIndex = function(predicateFn, opt_this) {};
/**
* @param {T} value
* @param {number=} opt_begin
* @param {number=} opt_end
* @return {!Array<T>}
* @this {!IArrayLike<T>|string}
* @template T
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.fill
*/
Array.prototype.fill = function(value, opt_begin, opt_end) {};
/**
* @param {number} target
* @param {number} start
* @param {number=} opt_end
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.copywithin
* @this {!IArrayLike<T>|string}
* @template T
* @return {!Array<T>}
*/
Array.prototype.copyWithin = function(target, start, opt_end) {};
/**
* NOTE: this is an ES2022 extern.
* @override
* @param {number} index
* @return {T}
* @this {!IArrayLike<T>|string}
* @template T
* @nosideeffects
* @see https://tc39.github.io/ecma262/#sec-array.prototype.at
*/
Array.prototype.at = function(index) {};
/**
* NOTE: this is an ES2016 (ES7) extern.
* @override
* @param {T} searchElement
* @param {number=} opt_fromIndex
* @return {boolean}
* @this {!IArrayLike<T>|string}
* @template T
* @nosideeffects
* @see https://tc39.github.io/ecma262/#sec-array.prototype.includes
*/
Array.prototype.includes = function(searchElement, opt_fromIndex) {};
/**
* Generates an array by passing every element of this array to a callback that
* returns an array of zero or more elements to be added to the result.
*
* NOTE: The specified behavior of the method is that the callback can return
* either an Array, which will be flattened into the result, or a non-array,
* which will simply be included.
*
* However, while defining that in the type information here is possible it's
* very hard to understand both for humans and automated tools other than
* closure-compiler that process these files. Also, we think it's best to
* encourage writing callbacks that just always return an Array for the sake
* of readability.
*
* The polyfill for this method provided by closure-compiler does behave as
* defined in the specification, though.
*
* @override
* @param {function(this: THIS, T, number, !IArrayLike<T>): !ReadonlyArray<S>}
* callback
* @param {THIS=} thisArg
* @return {!Array<S>}
* @this {!IArrayLike<T>}
* @template T, THIS, S
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flatMap
*/
Array.prototype.flatMap = function(callback, thisArg) {};
/**
* @override
* @param {number=} depth
* @return {!Array<S>}
* @this {!IArrayLike<T>}
* @template T, S
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat
*/
Array.prototype.flat = function(depth) {};
/**
* NOTE: this is an ES2023 extern.
* @override
* @return {!Array<T>}
* @this {!IArrayLike<T>}
* @template T
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toReversed
*/
Array.prototype.toReversed = function() {};
/**
* NOTE: this is an ES2023 extern.
* @override
* @param {function(T, T): number=} compareFn A function that defines the sort
* order.
* @return {!Array<T>}
* @this {!IArrayLike<T>}
* @template VALUE
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toSorted
*/
Array.prototype.toSorted = function(compareFn) {};
/**
* NOTE: this is an ES2023 extern.
* @override
* @param {number} start
* @param {number=} skipCount
* @param {...T} var_toAdd
* @return {!Array<T>}
* @this {!IArrayLike<T>}
* @template T
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toSpliced
*/
Array.prototype.toSpliced = function(start, skipCount, var_toAdd) {};
/**
* NOTE: this is an ES2023 extern.
* @override
* @param {number} index
* @param {T} value
* @return {!Array<T>}
* @this {!IArrayLike<T>}
* @template T
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/with
*/
Array.prototype.with = function(index, value) {};
/** @return {!IteratorIterable<number>} */
ReadonlyArray.prototype.keys;
/**
* @return {!IteratorIterable<T>}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/values
*/
ReadonlyArray.prototype.values;
/**
* @return {!IteratorIterable<!Array<number|T>>} Iterator of [key, value] pairs.
*/
ReadonlyArray.prototype.entries;
/**
* @param {function(this:S, T, number, !Array<T>): *} predicateFn
* @param {S=} opt_this
* @return {T|undefined}
* @this {IArrayLike<T>|string}
* @template T,S
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.find
*/
ReadonlyArray.prototype.find = function(predicateFn, opt_this) {};
/**
* @param {function(this:S, T, number, !Array<T>): *} predicateFn
* @param {S=} opt_this
* @return {number}
* @this {IArrayLike<T>|string}
* @template T,S
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-array.prototype.findindex
*/
ReadonlyArray.prototype.findIndex = function(predicateFn, opt_this) {};
/**
* NOTE: this is an ES2023 extern.
* @param {function(this:S, T, number, !Array<T>): boolean} predicateFn
* @param {S=} opt_this
* @return {T|undefined}
* @this {IArrayLike<T>|string}
* @template T,S
* @see https://tc39.es/ecma262/#sec-array.prototype.findlast
*/
ReadonlyArray.prototype.findLast = function(predicateFn, opt_this) {};
/**
* NOTE: this is an ES2023 extern.
* @param {function(this:S, T, number, !Array<T>): boolean} predicateFn
* @param {S=} opt_this
* @return {number}
* @this {IArrayLike<T>|string}
* @template T,S
* @see https://tc39.es/ecma262/#sec-array.prototype.findlastindex
*/
ReadonlyArray.prototype.findLastIndex = function(predicateFn, opt_this) {};
/**
* NOTE: this is an ES2022 extern.
* @param {number} index
* @return {T}
* @this {!IArrayLike<T>|string}
* @template T
* @nosideeffects
* @see https://tc39.github.io/ecma262/#sec-array.prototype.at
*/
ReadonlyArray.prototype.at = function(index) {};
/**
* NOTE: this is an ES2016 (ES7) extern.
* @param {?} searchElement
* @param {number=} opt_fromIndex
* @return {boolean}
* @this {!IArrayLike<T>|string}
* @template T
* @nosideeffects
* @see https://tc39.github.io/ecma262/#sec-array.prototype.includes
*/
ReadonlyArray.prototype.includes = function(searchElement, opt_fromIndex) {};
/**
* Generates an array by passing every element of this array to a callback that
* returns an array of zero or more elements to be added to the result.
*
* NOTE: The specified behavior of the method is that the callback can return
* either an Array, which will be flattened into the result, or a non-array,
* which will simply be included.
*
* However, while defining that in the type information here is possible it's
* very hard to understand both for humans and automated tools other than
* closure-compiler that process these files. Also, we think it's best to
* encourage writing callbacks that just always return an Array for the sake
* of readability.
*
* The polyfill for this method provided by closure-compiler does behave as
* defined in the specification, though.
*
* @param {function(this: THIS, T, number, !IArrayLike<T>): !ReadonlyArray<S>}
* callback
* @param {THIS=} thisArg
* @return {!Array<S>}
* @this {!IArrayLike<T>}
* @template T, THIS, S
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flatMap
*/
ReadonlyArray.prototype.flatMap = function(callback, thisArg) {};
/**
* @param {number=} depth
* @return {!Array<S>}
* @this {!IArrayLike<T>}
* @template T, S
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/flat
*/
ReadonlyArray.prototype.flat = function(depth) {};
/**
* NOTE: this is an ES2023 extern.
* @return {!Array<T>}
* @this {!IArrayLike<T>}
* @template T
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toReversed
*/
ReadonlyArray.prototype.toReversed = function() {};
/**
* NOTE: this is an ES2023 extern.
* @param {function(T, T): number=} compareFn A function that defines the sort
* order.
* @return {!Array<T>}
* @this {!IArrayLike<T>}
* @template T
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toSorted
*/
ReadonlyArray.prototype.toSorted = function(compareFn) {};
/**
* NOTE: this is an ES2023 extern.
* @param {number} start
* @param {number=} skipCount
* @param {...T} var_toAdd
* @return {!Array<T>}
* @this {!IArrayLike<T>}
* @template T
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/toSpliced
*/
ReadonlyArray.prototype.toSpliced = function(start, skipCount, var_toAdd) {};
/**
* NOTE: this is an ES2023 extern.
* @param {number} index
* @param {T} value
* @return {!Array<T>}
* @this {!IArrayLike<T>}
* @template T
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/with
*/
ReadonlyArray.prototype.with = function(index, value) {};
/**
* @param {!Iterable<*>} errors
* @param {string} message
* @constructor
* @extends {Error}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/AggregateError/AggregateError
*/
var AggregateError = function(errors, message) {};
/** @type {!Array<!Error>} */
AggregateError.prototype.errors;
/** @type {string} */
AggregateError.prototype.message;
/**
* @param {!Object} obj
* @return {!Array<symbol>}
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-object.getownpropertysymbols
*/
Object.getOwnPropertySymbols = function(obj) {};
/**
* @param {!Object} obj
* @param {?} proto
* @return {!Object}
* @see http://www.ecma-international.org/ecma-262/6.0/#sec-object.setprototypeof
*/
Object.setPrototypeOf = function(obj, proto) {};
/**
* @const {number}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/EPSILON
*/
Number.EPSILON;
/**
* @const {number}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MIN_SAFE_INTEGER
*/
Number.MIN_SAFE_INTEGER;
/**
* @const {number}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/MAX_SAFE_INTEGER
*/
Number.MAX_SAFE_INTEGER;
/**
* Parse an integer. Use of `parseInt` without `base` is strictly
* banned in Google. If you really want to parse octal or hex based on the
* leader, then pass `undefined` as the base.
*
* @param {string} string
* @param {number|undefined} radix
* @return {number}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/parseInt
*/
Number.parseInt = function(string, radix) {};
/**
* @param {string} string
* @return {number}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/parseFloat
*/
Number.parseFloat = function(string) {};
/**
* @param {*} value
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isNaN
*/
Number.isNaN = function(value) {};
/**
* @param {*} value
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isFinite
*/
Number.isFinite = function(value) {};
/**
* @param {*} value
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isInteger
*/
Number.isInteger = function(value) {};
/**
* @param {*} value
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isSafeInteger
*/
Number.isSafeInteger = function(value) {};
/**
* @param {!Object} target
* @param {...(Object|null|undefined)} var_args
* @return {!Object}
* @modifies {arguments}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/assign
*/
Object.assign = function(target, var_args) {};
/**
* TODO(dbeam): find a better place for ES2017 externs like this one.
* NOTE: this is an ES2017 (ES8) extern.
* @param {!Object<T>} obj
* @return {!Array<T>} values
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/values
* @throws {Error}
* @template T
*/
Object.values = function(obj) {};
/**
* NOTE: this is an ES2017 (ES8) extern.
* @param {!Object<T>} obj
* @return {!Array<!Array<(string|T)>>} entries
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/entries
* @throws {Error}
* @template T
*/
Object.entries = function(obj) {};
/**
* NOTE: this is an ES2022 extern.
* Returns whether the specified object has indicated property as its own
* property.
* @param {!Object} obj
* @param {string|symbol} propertyName
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwn
*/
Object.hasOwn = function(obj, propertyName) {};
/**
* @param {!Iterable<*>} iter
* @return {!Object}
* https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/fromEntries
*/
Object.fromEntries = function(iter) {};
/**
* NOTE: this is an ES2017 (ES8) extern.
* @param {!Object} obj
* @return {!Object<!ObjectPropertyDescriptor>} descriptors
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptors
* @throws {Error}
* @template T
*/
Object.getOwnPropertyDescriptors = function(obj) {};
/**
* @param {!Iterable<T>} items
* @param {function(T, number=): (string|symbol|number)} callbackFn
* @return {!Object<string|symbol|number, !Array<T>>}
* @template T
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/groupBy
*/
Object.groupBy = function(items, callbackFn) {};
/**
* @const
* @see http://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect
*/
var Reflect = {};
/**
* @param {function(this: THIS, ...?): RESULT} targetFn
* @param {THIS} thisArg
* @param {!Array<?>} argList
* @return {RESULT}
* @template THIS, RESULT
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/apply
*/
Reflect.apply = function(targetFn, thisArg, argList) {};
/**
* @param {function(new: ?, ...?)} targetConstructorFn
* @param {!Array<?>} argList
* @param {function(new: TARGET, ...?)=} opt_newTargetConstructorFn
* @return {TARGET}
* @template TARGET
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/construct
*/
Reflect.construct = function(
targetConstructorFn, argList, opt_newTargetConstructorFn) {};
/**
* @param {!Object} target
* @param {string} propertyKey
* @param {!ObjectPropertyDescriptor} attributes
* @return {boolean}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/defineProperty
*/
Reflect.defineProperty = function(target, propertyKey, attributes) {};
/**
* @param {!Object} target
* @param {string} propertyKey
* @return {boolean}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/deleteProperty
*/
Reflect.deleteProperty = function(target, propertyKey) {};
/**
* @param {!Object} target
* @param {string} propertyKey
* @param {!Object=} opt_receiver
* @return {*}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/get
*/
Reflect.get = function(target, propertyKey, opt_receiver) {};
/**
* @param {!Object} target
* @param {string} propertyKey
* @return {?ObjectPropertyDescriptor}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/getOwnPropertyDescriptor
*/
Reflect.getOwnPropertyDescriptor = function(target, propertyKey) {};
/**
* @param {!Object} target
* @return {?Object}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/getPrototypeOf
*/
Reflect.getPrototypeOf = function(target) {};
/**
* @param {!Object} target
* @param {string} propertyKey
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/has
*/
Reflect.has = function(target, propertyKey) {};
/**
* @param {!Object} target
* @return {boolean}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/isExtensible
*/
Reflect.isExtensible = function(target) {};
/**
* @param {!Object} target
* @return {!Array<(string|symbol)>}
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/ownKeys
*/
Reflect.ownKeys = function(target) {};
/**
* @param {!Object} target
* @return {boolean}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/preventExtensions
*/
Reflect.preventExtensions = function(target) {};
/**
* @param {!Object} target
* @param {string} propertyKey
* @param {*} value
* @param {!Object=} opt_receiver
* @return {boolean}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/set
*/
Reflect.set = function(target, propertyKey, value, opt_receiver) {};
/**
* @param {!Object} target
* @param {?Object} proto
* @return {boolean}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/setPrototypeOf
*/
Reflect.setPrototypeOf = function(target, proto) {};
/**
* @const
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics
*/
var Atomics = {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @param {number} value
* @return {number}
*/
Atomics.add = function(typedArray, index, value) {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @param {number} value
* @return {number}
*/
Atomics.and = function(typedArray, index, value) {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @param {number} expectedValue
* @param {number} replacementValue
* @return {number}
*/
Atomics.compareExchange = function(
typedArray, index, expectedValue, replacementValue) {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @param {number} value
* @return {number}
*/
Atomics.exchange = function(typedArray, index, value) {};
/**
* @param {number} size
* @return {boolean}
*/
Atomics.isLockFree = function(size) {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @return {number}
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Atomics/load
*/
Atomics.load = function(typedArray, index) {};
/**
* @param {!Int32Array|!BigInt64Array} typedArray
* @param {number} index
* @param {number=} count
* @return {number}
*/
Atomics.notify = function(typedArray, index, count) {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @param {number} value
* @return {number}
*/
Atomics.or = function(typedArray, index, value) {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @param {number} value
* @return {number}
*/
Atomics.store = function(typedArray, index, value) {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @param {number} value
* @return {number}
*/
Atomics.sub = function(typedArray, index, value) {};
/**
* @param {!Int32Array|!BigInt64Array} typedArray
* @param {number} index
* @param {number} value
* @param {number=} timeout
* @return {string}
*/
Atomics.wait = function(typedArray, index, value, timeout) {};
/**
* @param {!Int32Array|!BigInt64Array} typedArray
* @param {number} index
* @param {number} value
* @param {number=} timeout
* @return {{async: boolean, value: (string|!Promise<string>)}}
*/
Atomics.waitAsync = function(typedArray, index, value, timeout) {};
/**
* @param {!Int32Array} typedArray
* @param {number} index
* @param {number=} count
* @return {number}
*/
Atomics.wake = function(typedArray, index, count) {};
/**
* @param {!Int8Array|!Uint8Array|!Int16Array|!Uint16Array|!Int32Array|!Uint32Array|!BigInt64Array|!BigUint64Array}
* typedArray
* @param {number} index
* @param {number} value
* @return {number}
*/
Atomics.xor = function(typedArray, index, value) {};
/**
* TODO(b/142881197): TReturn and TNext are not yet used for anything.
* https://github.com/google/closure-compiler/issues/3489
* @interface
* @template T, TReturn, TNext
* @see https://tc39.github.io/proposal-async-iteration/
*/
function AsyncIterator() {}
/**
* @param {?=} opt_value
* @return {!Promise<!IIterableResult<T>>}
*/
AsyncIterator.prototype.next;
/**
* @interface
* @template T, TReturn, TNext
*/
function AsyncIterable() {}
/**
* @return {!AsyncIterator<T, ?, *>}
*/
AsyncIterable.prototype[Symbol.asyncIterator] = function() {};
/**
* @interface
* @extends {AsyncIterator<T, ?, *>}
* @extends {AsyncIterable<T>}
* @template T
* @see https://tc39.github.io/proposal-async-iteration/
*/
function AsyncIteratorIterable() {}
/**
* TODO(b/142881197): TReturn and TNext are not yet used for anything.
* https://github.com/google/closure-compiler/issues/3489
* @interface
* @see https://tc39.github.io/proposal-async-iteration/
* @extends {AsyncIteratorIterable<T, TReturn, TNext>}
* @template T, TReturn, TNext
*/
function AsyncGenerator() {}
/**
* @param {?=} opt_value
* @return {!Promise<!IIterableResult<T>>}
* @override
*/
AsyncGenerator.prototype.next = function(opt_value) {};
/**
* @param {T} value
* @return {!Promise<!IIterableResult<T>>}
*/
AsyncGenerator.prototype.return = function(value) {};
/**
* @param {?} exception
* @return {!Promise<!IIterableResult<T>>}
*/
AsyncGenerator.prototype.throw = function(exception) {};
/**
* @constructor
* @struct
* @param {TYPE} value
* @template TYPE
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakRef
*/
function WeakRef(value) {}
/**
* @return {TYPE}
* @nosideeffects
*/
WeakRef.prototype.deref = function() {};
/**
* @constructor
* @struct
* @param {function(HELDVALUE)} cleanupCallback
* @template TARGET, HELDVALUE, TOKEN
* @nosideeffects
* @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/FinalizationRegistry
*/
function FinalizationRegistry(cleanupCallback) {}
/**
* @param {TARGET} target
* @param {HELDVALUE} heldValue
* @param {TOKEN=} unregisterToken
* @return {void}
*/
FinalizationRegistry.prototype.register = function(
target, heldValue, unregisterToken) {};
/**
* @param {TOKEN} unregisterToken
* @return {void}
*/
FinalizationRegistry.prototype.unregister = function(unregisterToken) {};
/**
* @type {!Global}
*/
var globalThis;
/**
* @const {symbol}
*/
Symbol.dispose;
/**
* @const {symbol}
*/
Symbol.asyncDispose;
/**
* Wraps an error that suppresses another error, and the error that was
* suppressed.
*
* @constructor
* @extends {Error}
* @param {?} error The error that resulted in a suppression.
* @param {?} suppressed The error that was suppressed.
* @param {string=} message The message for the error.
* @return {!SuppressedError}
* @nosideeffects
*/
function SuppressedError(error, suppressed, message) {}
/**
* The error that resulted in a suppression.
* @type {?}
*/
SuppressedError.prototype.error;
/**
* The error that was suppressed.
* @type {?}
*/
SuppressedError.prototype.suppressed;
/**
* @record
*/
function Disposable() {}
/**
* @return {void}
*/
Disposable.prototype[Symbol.dispose] = function() {};
/**
* A DisposableStack is an object that can be used to contain one or more
* resources that should be disposed together.
*
* @constructor
*/
function DisposableStack() {}
/**
* @type {boolean}
*/
DisposableStack.prototype.disposed;
/**
* @return {void}
*/
DisposableStack.prototype.dispose = function() {};
/**
* @return {void}
*/
DisposableStack.prototype[Symbol.dispose] = function () {};
/**
* @param {!Disposable|null|undefined} disposable
* @return {!Disposable|null|undefined}
*/
DisposableStack.prototype.use = function(disposable) {};
/**
* @template T
* @param {T} value
* @param {function(T)} onDispose
* @return {T}
*/
DisposableStack.prototype.adopt = function(value, onDispose) {};
/**
* @param {function(): void} onDispose
* @return {void}
*/
DisposableStack.prototype.defer = function(onDispose) {};
/**
* @return {!DisposableStack}
*/
DisposableStack.prototype.move = function() {};
/**
* @record
*/
function AsyncDisposable() {}
/**
* @return {!Promise<void>}
*/
AsyncDisposable.prototype[Symbol.asyncDispose] = function() {};
/**
* An AsyncDisposableStack is an object that can be used to contain one or more
* resources that should be disposed of together. The resources may be disposed
* of asynchronously.
*
* @constructor
*/
function AsyncDisposableStack() {}
/**
* @type {boolean}
*/
AsyncDisposableStack.prototype.disposed;
/**
* @return {!Promise<void>}
*/
AsyncDisposableStack.prototype.disposeAsync = function() {};
/**
* @return {!Promise<void>}
*/
AsyncDisposableStack.prototype[Symbol.asyncDispose] = function () {};
/**
* @param {!AsyncDisposable|!Disposable|null|undefined} disposable
* @return {!AsyncDisposable|!Disposable|null|undefined}
*/
AsyncDisposableStack.prototype.use = function(disposable) {};
/**
* @template T
* @param {T} value
* @param {function(T): (void|!Promise<void>)} onDispose
* @return {T}
*/
AsyncDisposableStack.prototype.adopt = function(value, onDispose) {};
/**
* @param {function(): (void|!Promise<void>)} onDispose
* @return {void}
*/
AsyncDisposableStack.prototype.defer = function(onDispose) {};
/**
* @return {!AsyncDisposableStack}
*/
AsyncDisposableStack.prototype.move = function() {};