chromium-bidi 7.3.0 → 7.3.2

package/lib/esm/bidiMapper/modules/browser/ContextConfigStorage.d.ts

@@ -1,19 +1,42 @@
 import { ContextConfig } from './ContextConfig.js';
+/**
+ * Manages context-specific configurations. This class allows setting
+ * configurations at three levels: global, user context, and browsing context.
+ *
+ * When `getActiveConfig` is called, it merges the configurations in a specific
+ * order of precedence: `global -> user context -> browsing context`. For each
+ * configuration property, the value from the highest-precedence level that has a
+ * non-`undefined` value is used.
+ *
+ * The `update` methods (`updateGlobalConfig`, `updateUserContextConfig`,
+ * `updateBrowsingContextConfig`) merge the provided configuration with the
+ * existing one at the corresponding level. Properties with `undefined` values in
+ * the provided configuration are ignored, preserving the existing value.
+ */
 export declare class ContextConfigStorage {
     #private;
+    /**
+     * Updates the global configuration. Properties with `undefined` values in the
+     * provided `config` are ignored.
+     */
     updateGlobalConfig(config: ContextConfig): void;
+    /**
+     * Updates the configuration for a specific browsing context. Properties with
+     * `undefined` values in the provided `config` are ignored.
+     */
     updateBrowsingContextConfig(browsingContextId: string, config: ContextConfig): void;
+    /**
+     * Updates the configuration for a specific user context. Properties with
+     * `undefined` values in the provided `config` are ignored.
+     */
     updateUserContextConfig(userContext: string, config: ContextConfig): void;
-    getActiveConfig(topLevelBrowsingContextId?: string, userContext?: string): {
-        acceptInsecureCerts?: boolean;
-        viewport?: import("../../../protocol/protocol.js").BrowsingContext.Viewport | null;
-        devicePixelRatio?: number | null;
-        extraHeaders?: import("devtools-protocol").Protocol.Network.Headers;
-        geolocation?: import("../../../protocol/protocol.js").Emulation.GeolocationCoordinates | import("../../../protocol/protocol.js").Emulation.GeolocationPositionError | null;
-        locale?: string | null;
-        prerenderingDisabled?: boolean;
-        screenOrientation?: import("../../../protocol/protocol.js").Emulation.ScreenOrientation | null;
-        timezone?: string | null;
-        userPromptHandler?: import("../../../protocol/protocol.js").Session.UserPromptHandler;
-    };
+    /**
+     * Returns the current global configuration.
+     */
+    getGlobalConfig(): ContextConfig;
+    /**
+     * Calculates the active configuration by merging global, user context, and
+     * browsing context settings.
+     */
+    getActiveConfig(topLevelBrowsingContextId: string, userContext: string): ContextConfig;
 }

package/lib/esm/bidiMapper/modules/browser/ContextConfigStorage.js

@@ -15,49 +15,57 @@
  * limitations under the License.
  */
 import { ContextConfig } from './ContextConfig.js';
+/**
+ * Manages context-specific configurations. This class allows setting
+ * configurations at three levels: global, user context, and browsing context.
+ *
+ * When `getActiveConfig` is called, it merges the configurations in a specific
+ * order of precedence: `global -> user context -> browsing context`. For each
+ * configuration property, the value from the highest-precedence level that has a
+ * non-`undefined` value is used.
+ *
+ * The `update` methods (`updateGlobalConfig`, `updateUserContextConfig`,
+ * `updateBrowsingContextConfig`) merge the provided configuration with the
+ * existing one at the corresponding level. Properties with `undefined` values in
+ * the provided configuration are ignored, preserving the existing value.
+ */
 export class ContextConfigStorage {
     #global = new ContextConfig();
     #userContextConfigs = new Map();
     #browsingContextConfigs = new Map();
+    /**
+     * Updates the global configuration. Properties with `undefined` values in the
+     * provided `config` are ignored.
+     */
     updateGlobalConfig(config) {
-        this.#global = { ...this.#global, ...config };
+        this.#global = ContextConfig.merge(this.#global, config);
     }
+    /**
+     * Updates the configuration for a specific browsing context. Properties with
+     * `undefined` values in the provided `config` are ignored.
+     */
     updateBrowsingContextConfig(browsingContextId, config) {
-        if (this.#browsingContextConfigs.has(browsingContextId)) {
-            this.#browsingContextConfigs.set(browsingContextId, {
-                ...this.#browsingContextConfigs.get(browsingContextId),
-                ...config,
-            });
-        }
-        else {
-            this.#browsingContextConfigs.set(browsingContextId, config);
-        }
+        this.#browsingContextConfigs.set(browsingContextId, ContextConfig.merge(this.#browsingContextConfigs.get(browsingContextId), config));
     }
+    /**
+     * Updates the configuration for a specific user context. Properties with
+     * `undefined` values in the provided `config` are ignored.
+     */
     updateUserContextConfig(userContext, config) {
-        if (this.#userContextConfigs.has(userContext)) {
-            this.#userContextConfigs.set(userContext, {
-                ...this.#userContextConfigs.get(userContext),
-                ...config,
-            });
-        }
-        else {
-            this.#userContextConfigs.set(userContext, config);
-        }
+        this.#userContextConfigs.set(userContext, ContextConfig.merge(this.#userContextConfigs.get(userContext), config));
+    }
+    /**
+     * Returns the current global configuration.
+     */
+    getGlobalConfig() {
+        return this.#global;
     }
+    /**
+     * Calculates the active configuration by merging global, user context, and
+     * browsing context settings.
+     */
     getActiveConfig(topLevelBrowsingContextId, userContext) {
-        let result = { ...this.#global };
-        if (userContext !== undefined &&
-            this.#userContextConfigs.has(userContext)) {
-            result = { ...result, ...this.#userContextConfigs.get(userContext) };
-        }
-        if (topLevelBrowsingContextId !== undefined &&
-            this.#browsingContextConfigs.has(topLevelBrowsingContextId)) {
-            result = {
-                ...result,
-                ...this.#browsingContextConfigs.get(topLevelBrowsingContextId),
-            };
-        }
-        return result;
+        return ContextConfig.merge(this.#global, this.#userContextConfigs.get(userContext), this.#browsingContextConfigs.get(topLevelBrowsingContextId));
     }
 }
 //# sourceMappingURL=ContextConfigStorage.js.map

package/lib/esm/bidiMapper/modules/browser/ContextConfigStorage.js.map

@@ -1 +1 @@
-{"version":3,"file":"ContextConfigStorage.js","sourceRoot":"","sources":["../../../../../src/bidiMapper/modules/browser/ContextConfigStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEjD,MAAM,OAAO,oBAAoB;IAC/B,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;IAC9B,mBAAmB,GAAG,IAAI,GAAG,EAAyB,CAAC;IACvD,uBAAuB,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE3D,kBAAkB,CAAC,MAAqB;QACtC,IAAI,CAAC,OAAO,GAAG,EAAC,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,MAAM,EAAC,CAAC;IAC9C,CAAC;IAED,2BAA2B,CACzB,iBAAyB,EACzB,MAAqB;QAErB,IAAI,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACxD,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,iBAAiB,EAAE;gBAClD,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,iBAAiB,CAAC;gBACtD,GAAG,MAAM;aACV,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED,uBAAuB,CAAC,WAAmB,EAAE,MAAqB;QAChE,IAAI,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,EAAE;gBACxC,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC;gBAC5C,GAAG,MAAM;aACV,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,eAAe,CAAC,yBAAkC,EAAE,WAAoB;QACtE,IAAI,MAAM,GAAG,EAAC,GAAG,IAAI,CAAC,OAAO,EAAC,CAAC;QAC/B,IACE,WAAW,KAAK,SAAS;YACzB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,EACzC,CAAC;YACD,MAAM,GAAG,EAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAC,CAAC;QACrE,CAAC;QACD,IACE,yBAAyB,KAAK,SAAS;YACvC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAC3D,CAAC;YACD,MAAM,GAAG;gBACP,GAAG,MAAM;gBACT,GAAG,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,yBAAyB,CAAC;aAC/D,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
+{"version":3,"file":"ContextConfigStorage.js","sourceRoot":"","sources":["../../../../../src/bidiMapper/modules/browser/ContextConfigStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,oBAAoB;IAC/B,OAAO,GAAG,IAAI,aAAa,EAAE,CAAC;IAC9B,mBAAmB,GAAG,IAAI,GAAG,EAAyB,CAAC;IACvD,uBAAuB,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE3D;;;OAGG;IACH,kBAAkB,CAAC,MAAqB;QACtC,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,2BAA2B,CACzB,iBAAyB,EACzB,MAAqB;QAErB,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAC9B,iBAAiB,EACjB,aAAa,CAAC,KAAK,CACjB,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,iBAAiB,CAAC,EACnD,MAAM,CACP,CACF,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,uBAAuB,CAAC,WAAmB,EAAE,MAAqB;QAChE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAC1B,WAAW,EACX,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,CACvE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,yBAAiC,EAAE,WAAmB;QACpE,OAAO,aAAa,CAAC,KAAK,CACxB,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,WAAW,CAAC,EACzC,IAAI,CAAC,uBAAuB,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAC5D,CAAC;IACJ,CAAC;CACF"}

package/lib/esm/protocol/generated/webdriver-bidi.d.ts

@@ -1434,7 +1434,7 @@ export declare namespace Network {
 }
 export declare namespace Network {
     type SetExtraHeadersParameters = {
-        headers: [Network.Header, ...Network.Header[]];
+        headers: [...Network.Header[]];
         contexts?: [
             BrowsingContext.BrowsingContext,
             ...BrowsingContext.BrowsingContext[]

package/lib/esm/protocol-parser/generated/webdriver-bidi.js

@@ -1504,7 +1504,7 @@ export var Network;
 })(Network || (Network = {}));
 (function (Network) {
     Network.SetExtraHeadersParametersSchema = z.lazy(() => z.object({
-        headers: z.array(Network.HeaderSchema).min(1),
+        headers: z.array(Network.HeaderSchema),
         contexts: z
             .array(BrowsingContext.BrowsingContextSchema)
             .min(1)