commit 88ea51175c70c64704c7ca3290b8dd7474121e3c parent 7479d8079bb64b39e7560c749045e4890f0e72f1 Author: Mark Banner <standard8@mozilla.com> Date: Mon, 22 Dec 2025 12:39:06 +0000 Bug 2004680 - Automatically fix issues raised by jsdoc/check-tag-names. r=frontend-codestyle-reviewers Differential Revision: https://phabricator.services.mozilla.com/D275753 Diffstat:
67 files changed, 97 insertions(+), 98 deletions(-)
diff --git a/browser/components/downloads/DownloadSpamProtection.sys.mjs b/browser/components/downloads/DownloadSpamProtection.sys.mjs @@ -294,7 +294,7 @@ export class DownloadSpamProtection { /** * Represents a special Download object for download spam. * - * @extends Download + * @augments Download */ class DownloadSpam extends Download { constructor(url) { diff --git a/browser/components/preferences/dialogs/browserLanguages.js b/browser/components/preferences/dialogs/browserLanguages.js @@ -317,11 +317,11 @@ class SortedItemSelectList { /** * @typedef LocaleDisplayInfo * @type {object} - * @prop {string} id - A unique ID. - * @prop {string} label - The localized display name. - * @prop {string} value - The BCP 47 locale identifier or the word "search". - * @prop {boolean} canRemove - The default locale cannot be removed. - * @prop {boolean} installed - Whether or not the locale is installed. + * @property {string} id - A unique ID. + * @property {string} label - The localized display name. + * @property {string} value - The BCP 47 locale identifier or the word "search". + * @property {boolean} canRemove - The default locale cannot be removed. + * @property {boolean} installed - Whether or not the locale is installed. */ /** diff --git a/browser/extensions/newtab/content-src/components/DiscoveryStreamComponents/AdBanner/AdBanner.jsx b/browser/extensions/newtab/content-src/components/DiscoveryStreamComponents/AdBanner/AdBanner.jsx @@ -25,7 +25,7 @@ const PREF_PROMOCARD_VISIBLE = "discoverystream.promoCard.visible"; * @param type * @param prefs * @returns {Element} - * @constructor + * @class */ export const AdBanner = ({ spoc, diff --git a/browser/extensions/newtab/content-src/components/DiscoveryStreamComponents/AdBannerContextMenu/AdBannerContextMenu.jsx b/browser/extensions/newtab/content-src/components/DiscoveryStreamComponents/AdBannerContextMenu/AdBannerContextMenu.jsx @@ -19,7 +19,7 @@ import { LinkMenu } from "../../LinkMenu/LinkMenu"; * @param type * @param showAdReporting * @returns {Element} - * @constructor + * @class */ export function AdBannerContextMenu({ dispatch, diff --git a/devtools/client/framework/selection.js b/devtools/client/framework/selection.js @@ -158,7 +158,7 @@ class Selection extends EventEmitter { * Called when a target front is destroyed. * * @param {TargetFront} front - * @emits detached-front + * @fires detached-front */ onTargetDestroyed(targetFront) { // if the current walker belongs to the target that is destroyed, emit a `detached-front` diff --git a/devtools/client/fronts/inspector/rule-rewriter.js b/devtools/client/fronts/inspector/rule-rewriter.js @@ -67,7 +67,7 @@ const BLANK_LINE_RX = /^[ \t]*(?:\r\n|\n|\r|\f|$)/; */ class RuleRewriter { /** - * @constructor + * @class * @param {Window} win * @param {Function} isCssPropertyKnown * A function to check if the CSS property is known. This is either an diff --git a/devtools/client/inspector/rules/rules.js b/devtools/client/inspector/rules/rules.js @@ -878,7 +878,7 @@ class CssRuleView extends EventEmitter { /** * Actually update search data and update the UI to reflect the current search. * - * @emits ruleview-filtered + * @fires ruleview-filtered */ _doFilterStyles() { this.searchData = { diff --git a/devtools/client/performance-new/components/aboutprofiling/AboutProfiling.js b/devtools/client/performance-new/components/aboutprofiling/AboutProfiling.js @@ -76,7 +76,7 @@ function encodeShellValue(value) { * This component implements the button that triggers the menu that makes it * possible to show more actions. * - * @extends {React.PureComponent<ButtonProps, ButtonState>} + * @augments {React.PureComponent<ButtonProps, ButtonState>} */ class MoreActionsButtonImpl extends PureComponent { state = { @@ -249,7 +249,7 @@ const MoreActionsButton = connect(mapStateToButtonProps)(MoreActionsButtonImpl); * This is the top level component for the about:profiling page. It shares components * with the popup and DevTools page. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class AboutProfiling extends PureComponent { render() { diff --git a/devtools/client/performance-new/components/aboutprofiling/DirectoryPicker.js b/devtools/client/performance-new/components/aboutprofiling/DirectoryPicker.js @@ -42,7 +42,7 @@ const Localized = createFactory( * * [+] [-] * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class DirectoryPicker extends PureComponent { /** @param {Props} props */ diff --git a/devtools/client/performance-new/components/aboutprofiling/Presets.js b/devtools/client/performance-new/components/aboutprofiling/Presets.js @@ -42,7 +42,7 @@ const Localized = createFactory( * Switch between various profiler presets, which will override the individualized * settings for the profiler. * - * @extends {React.PureComponent<PresetProps>} + * @augments {React.PureComponent<PresetProps>} */ class Preset extends PureComponent { /** @@ -110,7 +110,7 @@ class Preset extends PureComponent { * Switch between various profiler presets, which will override the individualized * settings for the profiler. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class Presets extends PureComponent { /** diff --git a/devtools/client/performance-new/components/aboutprofiling/Range.js b/devtools/client/performance-new/components/aboutprofiling/Range.js @@ -29,7 +29,7 @@ const { /** * Provide a numeric range slider UI that works off of custom numeric scales. * - * @extends React.PureComponent<Props> + * @augments React.PureComponent<Props> */ class Range extends PureComponent { /** diff --git a/devtools/client/performance-new/components/aboutprofiling/Settings.js b/devtools/client/performance-new/components/aboutprofiling/Settings.js @@ -216,7 +216,7 @@ const jvmThreadColumns = [ /** * This component manages the settings for recording a performance profile. * - * @extends {React.PureComponent<Props, State>} + * @augments {React.PureComponent<Props, State>} */ class Settings extends PureComponent { /** diff --git a/devtools/client/performance-new/components/panel/Description.js b/devtools/client/performance-new/components/panel/Description.js @@ -26,7 +26,7 @@ const Localized = createFactory( * This component provides a helpful description for what is going on in the component * and provides some external links. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class Description extends PureComponent { /** diff --git a/devtools/client/performance-new/components/panel/DevToolsPanel.js b/devtools/client/performance-new/components/panel/DevToolsPanel.js @@ -63,7 +63,7 @@ const panelWindow = /** @type {PanelWindow} */ (anyWindow); /** * This is the top level component for the DevTools panel. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class DevToolsPanel extends PureComponent { render() { diff --git a/devtools/client/performance-new/components/panel/DevToolsPresetSelection.js b/devtools/client/performance-new/components/panel/DevToolsPresetSelection.js @@ -67,7 +67,7 @@ const Localized = createFactory( * is written using vanilla JS and browser chrome elements in order to be more * performant. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class DevToolsPresetSelection extends PureComponent { /** @param {Props} props */ diff --git a/devtools/client/performance-new/components/panel/OnboardingMessage.js b/devtools/client/performance-new/components/panel/OnboardingMessage.js @@ -41,7 +41,7 @@ const ONBOARDING_PREF = "devtools.performance.new-panel-onboarding"; * This component provides a temporary onboarding message for users migrating * from the old DevTools performance panel. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class OnboardingMessage extends PureComponent { /** diff --git a/devtools/client/performance-new/components/panel/ProfilerEventHandling.js b/devtools/client/performance-new/components/panel/ProfilerEventHandling.js @@ -56,7 +56,7 @@ const selectors = require("resource://devtools/client/performance-new/store/sele * suddenly becomes unavailable, it needs to react to those changes, and update the * recordingState in the store. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class ProfilerEventHandling extends PureComponent { componentDidMount() { diff --git a/devtools/client/performance-new/components/panel/RecordingButton.js b/devtools/client/performance-new/components/panel/RecordingButton.js @@ -63,7 +63,7 @@ const Localized = createFactory( * is only responsible for the actual act of stopping and starting recordings. It * also reacts to the changes of the recording state from external changes. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class RecordingButton extends PureComponent { _onStartButtonClick = () => { diff --git a/devtools/client/performance-new/components/panel/ToolboxHighlightController.js b/devtools/client/performance-new/components/panel/ToolboxHighlightController.js @@ -30,7 +30,7 @@ const { const selectors = require("resource://devtools/client/performance-new/store/selectors.js"); /** - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class ToolboxHighlightController extends PureComponent { /** @param {Props} prevProps */ diff --git a/devtools/client/performance-new/components/shared/ProfilerPreferenceObserver.js b/devtools/client/performance-new/components/shared/ProfilerPreferenceObserver.js @@ -55,7 +55,7 @@ const actions = require("resource://devtools/client/performance-new/store/action * This component mirrors the settings in the redux store and the preferences in * Firefox. * - * @extends {React.PureComponent<Props>} + * @augments {React.PureComponent<Props>} */ class ProfilerPreferenceObserver extends PureComponent { componentDidMount() { diff --git a/devtools/client/shared/sourceeditor/css-autocompleter.js b/devtools/client/shared/sourceeditor/css-autocompleter.js @@ -95,7 +95,7 @@ class CSSCompleter { ]); /** - * @constructor + * @class * @param options {Object} An options object containing the following options: * - walker {Object} The object used for query selecting from the current * target's DOM. diff --git a/devtools/client/shared/widgets/LinearEasingFunctionWidget.js b/devtools/client/shared/widgets/LinearEasingFunctionWidget.js @@ -33,7 +33,7 @@ const percentFormatter = new Intl.NumberFormat("en", { * only handle points inside [0,0] [1,1] to represent most common use cases (even though * the line will properly link points outside of this range) * - * @emits "updated" events whenever the line is changed, with the updated property value. + * @fires "updated" events whenever the line is changed, with the updated property value. */ class LinearEasingFunctionWidget extends EventEmitter { /** diff --git a/devtools/client/webconsole/browser-console.js b/devtools/client/webconsole/browser-console.js @@ -36,7 +36,7 @@ class BrowserConsole extends WebConsole { #bcDestroyer = null; #telemetry; /** - * @constructor + * @class * @param object commands * The commands object with all interfaces defined from devtools/shared/commands/ * @param nsIDOMWindow iframeWindow diff --git a/devtools/client/webconsole/components/Output/message-types/CSSWarning.js b/devtools/client/webconsole/components/Output/message-types/CSSWarning.js @@ -34,7 +34,7 @@ loader.lazyRequireGetter( * selectors match elements in the current page (warnings can appear for styles * which don't apply to the current page). * - * @extends Component + * @augments Component */ class CSSWarning extends Component { static get propTypes() { diff --git a/devtools/client/webconsole/webconsole.js b/devtools/client/webconsole/webconsole.js @@ -50,7 +50,7 @@ const isMacOS = Services.appinfo.OS === "Darwin"; */ class WebConsole { /** - * @constructor + * @class * @param object toolbox * The toolbox where the web console is displayed. * @param object commands diff --git a/devtools/server/actors/blackboxing.js b/devtools/server/actors/blackboxing.js @@ -23,7 +23,7 @@ const { BLACKBOXING } = SUPPORTED_DATA; * will be forwarded to the WatcherActor to populate the shared session data available to * all DevTools targets. * - * @constructor + * @class */ class BlackboxingActor extends Actor { constructor(watcherActor) { diff --git a/devtools/server/actors/breakpoint-list.js b/devtools/server/actors/breakpoint-list.js @@ -23,7 +23,7 @@ const { BREAKPOINTS, XHR_BREAKPOINTS, EVENT_BREAKPOINTS } = SUPPORTED_DATA; * will be forwarded to the WatcherActor to populate the shared session data available to * all DevTools targets. * - * @constructor + * @class */ class BreakpointListActor extends Actor { constructor(watcherActor) { diff --git a/devtools/server/actors/compatibility/compatibility.js b/devtools/server/actors/compatibility/compatibility.js @@ -30,7 +30,7 @@ class CompatibilityActor extends Actor { * @param inspector * The InspectorActor that owns this CompatibilityActor. * - * @constructor + * @class */ constructor(inspector) { super(inspector.conn, compatibilitySpec); diff --git a/devtools/server/actors/inspector/css-logic.js b/devtools/server/actors/inspector/css-logic.js @@ -816,7 +816,7 @@ class CssSheet { /** * A safe way to access cached bits of information about a stylesheet. * - * @constructor + * @class * @param {CssLogic} cssLogic pointer to the CssLogic instance working with * this CssSheet object. * @param {CSSStyleSheet} domSheet reference to a DOM CSSStyleSheet object. @@ -1030,7 +1030,7 @@ class CssRule { * will be an InspectorDeclaration (object of the form {style: element.style, declarationOrigin: string}). * @param {Element} [element] If the rule comes from element.style, then this * argument must point to the element. - * @constructor + * @class */ constructor(cssSheet, domRule, element) { this.#cssSheet = cssSheet; @@ -1171,7 +1171,7 @@ class CssSelector { * The CSS selector class allows us to document the ranking of various CSS * selectors. * - * @constructor + * @class * @param {CssRule} cssRule the CssRule instance from where the selector comes. * @param {string} selector The selector that we wish to investigate. * @param {number} index The index of the selector within it's rule. @@ -1327,7 +1327,7 @@ class CssPropertyInfo { * * @param {CssLogic} cssLogic Reference to the parent CssLogic instance * @param {string} property The CSS property we are gathering information for - * @constructor + * @class */ constructor(cssLogic, property) { this.#cssLogic = cssLogic; @@ -1489,7 +1489,6 @@ class CssSelectorInfo { * the selector. * @param {STATUS} status The selector match status. * @param {number} distance See CssLogic.#buildMatchedRules for definition. - * @constructor */ constructor(selector, property, value, status, distance) { this.selector = selector; diff --git a/devtools/server/actors/network-monitor/network-content.js b/devtools/server/actors/network-monitor/network-content.js @@ -37,7 +37,7 @@ const { * This actor manages all network functionality runnning * in the content process. * - * @constructor + * @class */ class NetworkContentActor extends Actor { constructor(conn, targetActor) { diff --git a/devtools/server/actors/network-monitor/network-event-actor.js b/devtools/server/actors/network-monitor/network-event-actor.js @@ -47,7 +47,7 @@ function isFileChannel(channel) { /** * Creates an actor for a network event. * - * @constructor + * @class * @param {DevToolsServerConnection} conn * The connection into which this Actor will be added. * @param {object} sessionContext diff --git a/devtools/server/actors/network-monitor/network-parent.js b/devtools/server/actors/network-monitor/network-parent.js @@ -18,7 +18,7 @@ const { * This actor manages all network functionality running * in the parent process. * - * @constructor + * @class */ class NetworkParentActor extends Actor { constructor(watcherActor) { diff --git a/devtools/server/actors/page-style.js b/devtools/server/actors/page-style.js @@ -74,7 +74,7 @@ class PageStyleActor extends Actor { * @param inspector * The InspectorActor that owns this PageStyleActor. * - * @constructor + * @class */ constructor(inspector) { super(inspector.conn, pageStyleSpec); diff --git a/devtools/server/actors/reflow.js b/devtools/server/actors/reflow.js @@ -427,7 +427,7 @@ exports.releaseLayoutChangesObserver = releaseLayoutChangesObserver; /** * Reports any reflow that occurs in the targetActor's docshells. * - * @extends Observable + * @augments Observable * @param {WindowGlobalTargetActor} targetActor * @param {Function} callback Executed everytime a reflow occurs */ @@ -470,7 +470,7 @@ ReflowObserver.prototype.QueryInterface = ChromeUtils.generateQI([ /** * Reports window resize events on the targetActor's windows. * - * @extends Observable + * @augments Observable * @param {WindowGlobalTargetActor} targetActor * @param {Function} callback Executed everytime a resize occurs */ diff --git a/devtools/server/actors/target-configuration.js b/devtools/server/actors/target-configuration.js @@ -80,7 +80,7 @@ const SUPPORTED_OPTIONS = { * (see _updateParentProcessConfiguration), and others will be set from the target actor, * in the content process. * - * @constructor + * @class */ class TargetConfigurationActor extends Actor { constructor(watcherActor) { diff --git a/devtools/server/actors/thread-configuration.js b/devtools/server/actors/thread-configuration.js @@ -54,7 +54,7 @@ const SUPPORTED_OPTIONS = { * flags when they are created. The flags will be forwarded to the WatcherActor * and stored as THREAD_CONFIGURATION data entries. * - * @constructor + * @class */ class ThreadConfigurationActor extends Actor { constructor(watcherActor) { diff --git a/devtools/server/actors/utils/stylesheets-manager.js b/devtools/server/actors/utils/stylesheets-manager.js @@ -60,7 +60,7 @@ const modifiedStyleSheets = new WeakMap(); /** * Manage stylesheets related to a given Target Actor. * - * @emits stylesheet-updated: emitted when there was changes in a stylesheet + * @fires stylesheet-updated: emitted when there was changes in a stylesheet * First arg is an object with the following properties: * - resourceId {String}: The id that was assigned to the stylesheet * - updateKind {String}: Which kind of update it is ("style-applied", diff --git a/devtools/server/actors/webconsole.js b/devtools/server/actors/webconsole.js @@ -128,7 +128,7 @@ function isObject(value) { * The WebConsoleActor implements capabilities needed for the Web Console * feature. * - * @constructor + * @class * @param object connection * The connection to the client, DevToolsServerConnection. * @param object [targetActor] diff --git a/devtools/server/actors/webconsole/listeners/console-api.js b/devtools/server/actors/webconsole/listeners/console-api.js @@ -15,7 +15,7 @@ const { * The window.console API observer. This allows the window.console API messages * to be sent to the remote Web Console instance. * - * @constructor + * @class * @param nsIDOMWindow window * Optional - the window object for which we are created. This is used * for filtering out messages that belong to other windows. diff --git a/devtools/server/actors/webconsole/listeners/console-service.js b/devtools/server/actors/webconsole/listeners/console-service.js @@ -17,7 +17,7 @@ const { * The nsIConsoleService listener. This is used to send all of the console * messages (JavaScript, CSS and more) to the remote Web Console instance. * - * @constructor + * @class * @param nsIDOMWindow [window] * Optional - the window object for which we are created. This is used * for filtering out messages that belong to other windows. diff --git a/devtools/shared/inspector/css-logic.js b/devtools/shared/inspector/css-logic.js @@ -14,7 +14,7 @@ const MAX_DATA_URL_LENGTH = 40; * - why their expectations may not have been fulfilled * - how browsers process CSS * - * @constructor + * @class */ loader.lazyRequireGetter( diff --git a/devtools/shared/network-observer/NetworkObserver.sys.mjs b/devtools/shared/network-observer/NetworkObserver.sys.mjs @@ -98,7 +98,7 @@ const HTTP_DOWNLOAD_ACTIVITIES = [ * http-on-examine-response notifications. All network request information is * routed to the remote Web Console. * - * @constructor + * @class * @param {object} options * @param {Function(nsIChannel): boolean} options.ignoreChannelFunction * This function will be called for every detected channel to decide if it diff --git a/devtools/shared/network-observer/NetworkResponseListener.sys.mjs b/devtools/shared/network-observer/NetworkResponseListener.sys.mjs @@ -32,7 +32,7 @@ ChromeUtils.defineESModuleGetters( * http://www.softwareishard.com/blog/firebug/ * nsitraceablechannel-intercept-http-traffic/ * - * @constructor + * @class * @param {object} httpActivity * HttpActivity object associated with this request. See NetworkObserver * more information. diff --git a/devtools/shared/protocol/Actor.js b/devtools/shared/protocol/Actor.js @@ -30,7 +30,7 @@ exports.actorSpecs = actorSpecs; * Either a DevToolsServerConnection or a DevToolsClient. Must have * addActorPool, removeActorPool, and poolFor. * conn can be null if the subclass provides a conn property. - * @constructor + * @class */ class Actor extends Pool { diff --git a/devtools/shared/protocol/Front.js b/devtools/shared/protocol/Front.js @@ -26,7 +26,7 @@ var { * @param [Front|null] parentFront * The parent front. This is only available if the Front being initialized is a child * of a parent front. - * @constructor + * @class */ class Front extends Pool { constructor(conn = null, targetFront = null, parentFront = null) { diff --git a/devtools/shared/protocol/Pool.js b/devtools/shared/protocol/Pool.js @@ -20,7 +20,7 @@ var EventEmitter = require("resource://devtools/shared/event-emitter.js"); * conn can be null if the subclass provides a conn property. * @param {string} [label] * An optional label for the Pool. - * @constructor + * @class */ class Pool extends EventEmitter { constructor(conn, label) { diff --git a/dom/media/webrtc/tests/mochitests/head.js b/dom/media/webrtc/tests/mochitests/head.js @@ -91,7 +91,7 @@ var DefaultLoopbackTone = null; * This class provides helpers around analysing the audio content in a stream * using WebAudio AnalyserNodes. * - * @constructor + * @class * @param {object} stream * A MediaStream object whose audio track we shall analyse. */ @@ -1038,7 +1038,7 @@ const GleanTest = new Proxy( * This class executes a series of functions in a continuous sequence. * Promise-bearing functions are executed after the previous promise completes. * - * @constructor + * @class * @param {object} framework * A back reference to the framework which makes use of the class. It is * passed to each command callback. diff --git a/dom/media/webrtc/tests/mochitests/pc.js b/dom/media/webrtc/tests/mochitests/pc.js @@ -49,7 +49,7 @@ var makeDefaultCommands = () => { /** * This class handles tests for peer connections. * - * @constructor + * @class * @param {object} [options={}] * Optional options for the peer connection test * @param {object} [options.commands=commandsPeerConnection] @@ -688,7 +688,7 @@ PeerConnectionTest.prototype.getSignalingMessage = function (messageType) { * * @param dataChannel * @param peerConnectionWrapper - * @constructor + * @class */ function DataChannelWrapper(dataChannel, peerConnectionWrapper) { this._channel = dataChannel; @@ -848,7 +848,7 @@ DataChannelWrapper.prototype = { /** * This class acts as a wrapper around a PeerConnection instance. * - * @constructor + * @class * @param {string} label * Description for the peer connection instance * @param {object} configuration diff --git a/dom/xhr/tests/test_XHR_timeout.js b/dom/xhr/tests/test_XHR_timeout.js @@ -56,7 +56,7 @@ function ok(bool, msg) { * @note If resetAfter and resetTo are omitted, only the initial timeout setting * applies. * - * @constructor + * @class * @implements DOMEventListener */ function RequestTracker(async, id, timeLimit /*[, resetAfter, resetTo]*/) { diff --git a/layout/style/test/test_flexbox_child_display_values.xhtml b/layout/style/test/test_flexbox_child_display_values.xhtml @@ -31,7 +31,7 @@ https://bugzilla.mozilla.org/show_bug.cgi?id=783415 /** * Utility function for getting computed style of "display". * - * @arg aElem The element to query for its computed "display" value. + * @param aElem The element to query for its computed "display" value. * @return The computed display value */ function getComputedDisplay(aElem) { @@ -42,15 +42,15 @@ function getComputedDisplay(aElem) { * Function used for testing a given specified "display" value and checking * its computed value against expectations. * - * @arg aSpecifiedDisplay + * @param aSpecifiedDisplay * The specified value of "display" that we should test. * - * @arg aExpectedDisplayAsFlexContainerChild + * @param aExpectedDisplayAsFlexContainerChild * (optional) The expected computed "display" when an element with * aSpecifiedDisplay is a child of a flex container. If omitted, * this argument defaults to aSpecifiedDisplay. * - * @arg aExpectedDisplayAsOutOfFlowFlexContainerChild + * @param aExpectedDisplayAsOutOfFlowFlexContainerChild * (optional) The expected computed "display" when an element with * aSpecifiedDisplay is a child of a flex container *and* has * position:[fixed|absolute] or float: [left|right] set. If omitted, diff --git a/layout/style/test/test_transitions_per_property.html b/layout/style/test/test_transitions_per_property.html @@ -2748,8 +2748,8 @@ function test_background_position_coord_transition(prop) { * Common tests for 'background-position', 'background-size', and other * properties that take CSS value-type 'position' or 'bg-size'. * - * @arg prop The name of the property - * @arg doesPropTakeListValues + * @param prop The name of the property + * @param doesPropTakeListValues * If false, the property is assumed to just take a single 'position' or * 'bg-size' value. If true, the property is assumed to also accept * comma-separated list of such values. diff --git a/netwerk/test/unit/test_cache2_nostore.js b/netwerk/test/unit/test_cache2_nostore.js @@ -2,7 +2,7 @@ /* vim: set ts=2 sw=2 sts=2 et: */ /** - * @fileoverview + * @file * Unit test to verify that resources with Cache-Control: no-store, no-cache * and Cache-Control: no-cache, no-store headers are not saved in the cache. */ diff --git a/services/fxaccounts/FxAccountsClient.sys.mjs b/services/fxaccounts/FxAccountsClient.sys.mjs @@ -536,7 +536,7 @@ FxAccountsClient.prototype = { /** * Register a new device * - * @method registerDevice + * @function registerDevice * @param sessionTokenHex * Session token obtained from signIn * @param name @@ -584,7 +584,7 @@ FxAccountsClient.prototype = { * Sends a message to other devices. Must conform with the push payload schema: * https://github.com/mozilla/fxa-auth-server/blob/master/docs/pushpayloads.schema.json * - * @method notifyDevice + * @function notifyDevice * @param sessionTokenHex * Session token obtained from signIn * @param deviceIds @@ -627,7 +627,7 @@ FxAccountsClient.prototype = { /** * Retrieves pending commands for our device. * - * @method getCommands + * @function getCommands * @param sessionTokenHex - Session token obtained from signIn * @param [index] - If specified, only messages received after the one who * had that index will be retrieved. @@ -652,7 +652,7 @@ FxAccountsClient.prototype = { /** * Invokes a command on another device. * - * @method invokeCommand + * @function invokeCommand * @param sessionTokenHex - Session token obtained from signIn * @param command - Name of the command to invoke * @param target - Recipient device ID. @@ -681,7 +681,7 @@ FxAccountsClient.prototype = { /** * Update the session or name for an existing device * - * @method updateDevice + * @function updateDevice * @param sessionTokenHex * Session token obtained from signIn * @param id @@ -726,7 +726,7 @@ FxAccountsClient.prototype = { * Get a list of currently registered devices that have been accessed * in the last `DEVICES_FILTER_DAYS` days * - * @method getDeviceList + * @function getDeviceList * @param sessionTokenHex * Session token obtained from signIn * @return Promise diff --git a/services/fxaccounts/FxAccountsProfileClient.sys.mjs b/services/fxaccounts/FxAccountsProfileClient.sys.mjs @@ -32,7 +32,7 @@ import { RESTRequest } from "resource://services-common/rest.sys.mjs"; * @param {string} options.serverURL * The URL of the profile server to query. * Example: https://profile.accounts.firefox.com/v1 - * @constructor + * @class */ export var FxAccountsProfileClient = function (options) { if (!options?.serverURL) { @@ -232,7 +232,7 @@ FxAccountsProfileClient.prototype = { * Error description * @param {string | null} [details.message] * Error message - * @constructor + * @class */ export var FxAccountsProfileClientError = function (details) { details = details || {}; diff --git a/services/fxaccounts/FxAccountsPush.sys.mjs b/services/fxaccounts/FxAccountsPush.sys.mjs @@ -25,7 +25,7 @@ import { * * @param [options] * Object, custom options that used for testing - * @constructor + * @class */ export function FxAccountsPushService(options = {}) { this.log = log; diff --git a/services/fxaccounts/FxAccountsWebChannel.sys.mjs b/services/fxaccounts/FxAccountsWebChannel.sys.mjs @@ -153,7 +153,7 @@ function getErrorDetails(error) { * The ID of the WebChannel * @param {string} options.helpers * Helpers functions. Should only be passed in for testing. - * @constructor + * @class */ export function FxAccountsWebChannel(options) { if (!options) { diff --git a/toolkit/components/asyncshutdown/nsAsyncShutdown.sys.mjs b/toolkit/components/asyncshutdown/nsAsyncShutdown.sys.mjs @@ -104,7 +104,7 @@ class PropertyBagConverter { * @param {object} moduleClient A client, as returned from the `client` * property of an instance of `AsyncShutdown.Barrier`. This client will * serve as back-end for methods `addBlocker` and `removeBlocker`. - * @constructor + * @class */ function nsAsyncShutdownClient(moduleClient) { if (!moduleClient) { @@ -181,7 +181,7 @@ nsAsyncShutdownClient.prototype = { * @param {object} moduleBarrier an instance if * `AsyncShutdown.Barrier`. This instance will serve as back-end for * all methods. - * @constructor + * @class */ function nsAsyncShutdownBarrier(moduleBarrier) { this._client = new nsAsyncShutdownClient(moduleBarrier.client); diff --git a/toolkit/components/passwordmgr/LoginRecipes.sys.mjs b/toolkit/components/passwordmgr/LoginRecipes.sys.mjs @@ -32,7 +32,7 @@ ChromeUtils.defineLazyGetter(lazy, "log", () => * Consumers should wait until {@link initializationPromise} resolves before * calling methods on the object. * - * @constructor + * @class * @param {string} [aOptions.defaults=null] the URI to load the recipes from. * If it's null, nothing is loaded. */ diff --git a/toolkit/components/passwordmgr/PasswordRulesManager.sys.mjs b/toolkit/components/passwordmgr/PasswordRulesManager.sys.mjs @@ -22,7 +22,7 @@ ChromeUtils.defineLazyGetter(lazy, "log", () => { * Handles interactions between PasswordRulesParser and the "password-rules" Remote Settings collection * * @class PasswordRulesManagerParent - * @extends {JSWindowActorParent} + * @augments {JSWindowActorParent} */ export class PasswordRulesManagerParent extends JSWindowActorParent { /** diff --git a/toolkit/components/promiseworker/worker/PromiseWorker.template.worker.js b/toolkit/components/promiseworker/worker/PromiseWorker.template.worker.js @@ -48,7 +48,7 @@ importScripts("resource://gre/modules/workers/require.js"); * - {Array} transfers An array of objects that should be transferred * instead of being copied. * - * @constructor + * @class */ function Meta(data, meta) { this.data = data; diff --git a/toolkit/components/timermanager/UpdateTimerManager.sys.mjs b/toolkit/components/timermanager/UpdateTimerManager.sys.mjs @@ -39,7 +39,7 @@ function LOG(string, alwaysLog = false) { * A manager for timers. Manages timers that fire over long periods of time * (e.g. days, weeks, months). * - * @constructor + * @class */ export function TimerManager() { Services.obs.addObserver(this, "profile-before-change"); diff --git a/toolkit/modules/PropertyListUtils.sys.mjs b/toolkit/modules/PropertyListUtils.sys.mjs @@ -828,7 +828,7 @@ XMLPropertyListReader.prototype = { * * @member _lazyGetters * Set() object to hold keys invoking LazyGetter. - * @method get + * @function get * Trap for getting property values. Ensures that if a lazyGetter is present * as value for key, then the function is evaluated, the value is cached, * and its value will be returned. diff --git a/toolkit/modules/WebChannel.sys.mjs b/toolkit/modules/WebChannel.sys.mjs @@ -82,7 +82,7 @@ export var WebChannelBroker = Object.create({ * If a string, it names a permission, and incoming events will be accepted * from any https:// origin that has been granted that permission by the * permission manager. - * @constructor + * @class */ export var WebChannel = function (id, originOrPermission) { if (!id || !originOrPermission) { diff --git a/toolkit/mozapps/extensions/AddonManager.sys.mjs b/toolkit/mozapps/extensions/AddonManager.sys.mjs @@ -4334,7 +4334,7 @@ export var AddonManager = { return gStartedPromise.promise; }, - /** @constructor */ + /** @class */ init() { this._stateToString = new Map(); for (let [name, value] of this._states) { diff --git a/toolkit/mozapps/extensions/Blocklist.sys.mjs b/toolkit/mozapps/extensions/Blocklist.sys.mjs @@ -1450,7 +1450,7 @@ var gBlocklistLevel = DEFAULT_LEVEL; * extensions/plugins. */ /** - * @method prompt + * @function prompt * * Prompt the user about newly blocked addons. The prompt is then resposible * for soft-blocking any addons that need to be afterwards diff --git a/toolkit/mozapps/update/UpdateService.sys.mjs b/toolkit/mozapps/update/UpdateService.sys.mjs @@ -2111,7 +2111,7 @@ class UpdatePatch { * @param patch * A <patch> element to initialize this object with * @throws if patch has a size of 0 - * @constructor + * @class */ constructor(patch) { this._properties = {}; @@ -2324,7 +2324,7 @@ class Update { * @param update * An <update> element to initialize this object with * @throws if the update contains no patches - * @constructor + * @class */ constructor(update) { this._patches = []; @@ -2701,7 +2701,7 @@ export class UpdateService { * UpdateService * A Service for managing the discovery and installation of software updates. * - * @constructor + * @class */ constructor() { LOG("Creating UpdateService"); @@ -4623,7 +4623,7 @@ export class UpdateManager { /** * A service to manage active and past updates. * - * @constructor + * @class */ constructor() { this.internal = { @@ -5973,7 +5973,7 @@ class Downloader { * update mode. * @param updateService * The update service that created this downloader. - * @constructor + * @class */ constructor(updateService) { LOG("Creating Downloader"); diff --git a/tools/profiler/tests/xpcshell/test_feature_fileioall.js b/tools/profiler/tests/xpcshell/test_feature_fileioall.js @@ -92,9 +92,9 @@ add_task(async () => { /** * @typedef {object} TestConfig - * @prop {Array} features The list of profiler features - * @prop {string[]} threadsFilter The list of threads to profile - * @prop {string} filename A filename to trigger a write operation + * @property {Array} features The list of profiler features + * @property {string[]} threadsFilter The list of threads to profile + * @property {string} filename A filename to trigger a write operation */ /**