@serwist/window 9.0.0-preview.3 → 9.0.0-preview.5

package/dist/Serwist.d.ts

@@ -31,13 +31,11 @@ export declare class Serwist extends SerwistEventTarget {
      * options. The script URL and options are the same as those used when
      * calling [navigator.serviceWorker.register(scriptURL, options)](https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer/register).
      *
-     * @param scriptURL The service worker script
-     *     associated with this instance. Using a
-     *     [`TrustedScriptURL`](https://web.dev/trusted-types/) is supported.
-     * @param registerOptions The service worker options associated
-     *     with this instance.
+     * @param scriptURL The service worker script associated with this instance. Using a
+     * [`TrustedScriptURL`](https://developer.mozilla.org/en-US/docs/Web/API/TrustedScriptURL) is supported.
+     * @param registerOptions The service worker options associated with this instance.
      */
-    constructor(scriptURL: string | TrustedScriptURL, registerOptions?: {});
+    constructor(scriptURL: string | TrustedScriptURL, registerOptions?: RegistrationOptions);
     /**
      * Registers a service worker for this instances script URL and service
      * worker options. By default this method delays registration until after
@@ -108,7 +106,7 @@ export declare class Serwist extends SerwistEventTarget {
      * @param data An object to send to the service worker
      * @returns
      */
-    messageSW(data: object): Promise<any>;
+    messageSW(data: any): Promise<any>;
     /**
      * Sends a `{type: 'SKIP_WAITING'}` message to the service worker that's
      * currently in the `waiting` state associated with the current registration.

package/dist/Serwist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Serwist.d.ts","sourceRoot":"","sources":["../src/Serwist.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAgBnE;;;;;;;;;;GAUG;AACH,qBAAa,OAAQ,SAAQ,kBAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IAC5D,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAC3E,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA2C;IAEhF,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,SAAS,CAAC,CAAU;IAC5B,OAAO,CAAC,wBAAwB,CAAC,CAAgB;IACjD,OAAO,CAAC,aAAa,CAAC,CAA4B;IAClD,OAAO,CAAC,GAAG,CAAC,CAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,eAAe,CAAC,CAAS;IAEjC;;;;;;;;;;OAUG;gBAES,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE,eAAe,GAAE,EAAO;IAY1E;;;;;;OAMG;IACG,QAAQ,CAAC,EACb,SAAiB,GAClB,GAAE;QACD;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IAkGvD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B;;;;;;;;OAQG;IACH,IAAI,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,CAEnC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAExC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAM/B;;;;;;;;;;;;OAYG;IAGG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAK3C;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IAM1B;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAQrC;;;;;OAKG;YACW,eAAe;IAsB7B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAwE7B;IAEF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAqF7B;IAEF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAuBlC;IAEF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CA2BzB;CACH;AAKD;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;GAaG"}
+{"version":3,"file":"Serwist.d.ts","sourceRoot":"","sources":["../src/Serwist.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAK1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAgBnE;;;;;;;;;;GAUG;AACH,qBAAa,OAAQ,SAAQ,kBAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IAC5D,OAAO,CAAC,iBAAiB,CAAK;IAG9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IACvE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAC3E,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA2C;IAEhF,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,SAAS,CAAC,CAAU;IAC5B,OAAO,CAAC,wBAAwB,CAAC,CAAgB;IACjD,OAAO,CAAC,aAAa,CAAC,CAA4B;IAClD,OAAO,CAAC,GAAG,CAAC,CAAgB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,WAAW,CAAC,CAAgB;IACpC,OAAO,CAAC,eAAe,CAAC,CAAS;IAEjC;;;;;;;;OAQG;gBACS,SAAS,EAAE,MAAM,GAAG,gBAAgB,EAAE,eAAe,GAAE,mBAAwB;IAY3F;;;;;;OAMG;IACG,QAAQ,CAAC,EACb,SAAiB,GAClB,GAAE;QACD;;;WAGG;QACH,SAAS,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,yBAAyB,GAAG,SAAS,CAAC;IA8FvD;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAY7B;;;;;;;;OAQG;IACH,IAAI,MAAM,IAAI,OAAO,CAAC,aAAa,CAAC,CAEnC;IAED;;;;;;;;;;;OAWG;IACH,IAAI,WAAW,IAAI,OAAO,CAAC,aAAa,CAAC,CAExC;IAED;;;;;;;;;;;;;;OAcG;IACH,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC;IAM/B;;;;;;;;;;;;OAYG;IAEG,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAKxC;;;;;;OAMG;IACH,kBAAkB,IAAI,IAAI;IAM1B;;;;;;OAMG;IACH,OAAO,CAAC,6BAA6B;IAQrC;;;;;OAKG;YACW,eAAe;IAsB7B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAsE7B;IAEF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAqF7B;IAEF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAuBlC;IAEF;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAuBzB;CACH;AAKD;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;;;;;;GAaG"}

package/dist/index.js

@@ -1,6 +1,6 @@
-import { Deferred, logger, dontWaitFor } from '@serwist/core/internal';
+import { Deferred, logger } from '@serwist/core/internal';
 
-function messageSW(sw, data) {
+const messageSW = (sw, data)=>{
     return new Promise((resolve)=>{
         const messageChannel = new MessageChannel();
         messageChannel.port1.onmessage = (event)=>{
@@ -10,7 +10,7 @@ function messageSW(sw, data) {
             messageChannel.port2
         ]);
     });
-}
+};
 
 class SerwistEvent {
     type;
@@ -82,7 +82,7 @@ class Serwist extends SerwistEventTarget {
     async register({ immediate = false } = {}) {
         if (process.env.NODE_ENV !== "production") {
             if (this._registrationTime) {
-                logger.error("Cannot re-register a Serwist instance after it has " + "been registered. Create a new instance instead.");
+                logger.error("Cannot re-register a Serwist instance after it has been registered. Create a new instance instead.");
                 return;
             }
         }
@@ -103,15 +103,15 @@ class Serwist extends SerwistEventTarget {
         const waitingSW = this._registration.waiting;
         if (waitingSW && urlsMatch(waitingSW.scriptURL, this._scriptURL.toString())) {
             this._sw = waitingSW;
-            dontWaitFor(Promise.resolve().then(()=>{
+            void Promise.resolve().then(()=>{
                 this.dispatchEvent(new SerwistEvent("waiting", {
                     sw: waitingSW,
                     wasWaitingBeforeRegister: true
                 }));
                 if (process.env.NODE_ENV !== "production") {
-                    logger.warn("A service worker was already waiting to activate " + "before this script was registered...");
+                    logger.warn("A service worker was already waiting to activate before this script was registered...");
                 }
-            }));
+            });
         }
         if (this._sw) {
             this._swDeferred.resolve(this._sw);
@@ -121,9 +121,9 @@ class Serwist extends SerwistEventTarget {
             logger.log("Successfully registered service worker.", this._scriptURL.toString());
             if (navigator.serviceWorker.controller) {
                 if (this._compatibleControllingSW) {
-                    logger.debug("A service worker with the same script URL " + "is already controlling this page.");
+                    logger.debug("A service worker with the same script URL is already controlling this page.");
                 } else {
-                    logger.debug("A service worker with a different script URL is " + "currently controlling the page. The browser is now fetching " + "the new script now...");
+                    logger.debug("A service worker with a different script URL is currently controlling the page. The browser is now fetching the new script now...");
                 }
             }
             const currentPageIsOutOfScope = ()=>{
@@ -132,7 +132,7 @@ class Serwist extends SerwistEventTarget {
                 return !location.pathname.startsWith(scopeURLBasePath);
             };
             if (currentPageIsOutOfScope()) {
-                logger.warn("The current page is not in scope for the registered " + "service worker. Was this a mistake?");
+                logger.warn("The current page is not in scope for the registered service worker. Was this a mistake?");
             }
         }
         this._registration.addEventListener("updatefound", this._onUpdateFound);
@@ -142,7 +142,7 @@ class Serwist extends SerwistEventTarget {
     async update() {
         if (!this._registration) {
             if (process.env.NODE_ENV !== "production") {
-                logger.error("Cannot update a Serwist instance without " + "being registered. Register the Serwist instance first.");
+                logger.error("Cannot update a Serwist instance without being registered. Register the Serwist instance first.");
             }
             return;
         }
@@ -188,7 +188,7 @@ class Serwist extends SerwistEventTarget {
     _onUpdateFound = (originalEvent)=>{
         const registration = this._registration;
         const installingSW = registration.installing;
-        const updateLikelyTriggeredExternally = this._updateFoundCount > 0 || !urlsMatch(installingSW.scriptURL, this._scriptURL.toString()) || performance.now() > this._registrationTime + REGISTRATION_TIMEOUT_DURATION ? true : false;
+        const updateLikelyTriggeredExternally = this._updateFoundCount > 0 || !urlsMatch(installingSW.scriptURL, this._scriptURL.toString()) || performance.now() > this._registrationTime + REGISTRATION_TIMEOUT_DURATION;
         if (updateLikelyTriggeredExternally) {
             this._externalSW = installingSW;
             registration.removeEventListener("updatefound", this._onUpdateFound);

package/dist/messageSW.d.ts

@@ -11,6 +11,5 @@
  * @param data An object to send to the service worker.
  * @returns
  */
-declare function messageSW(sw: ServiceWorker, data: {}): Promise<any>;
-export { messageSW };
+export declare const messageSW: (sw: ServiceWorker, data: any) => Promise<any>;
 //# sourceMappingURL=messageSW.d.ts.map

package/dist/messageSW.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messageSW.d.ts","sourceRoot":"","sources":["../src/messageSW.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AAEH,iBAAS,SAAS,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,CAQ5D;AAED,OAAO,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"messageSW.d.ts","sourceRoot":"","sources":["../src/messageSW.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,SAAS,OAAQ,aAAa,QAAQ,GAAG,KAAG,QAAQ,GAAG,CAQnE,CAAC"}

package/dist/utils/urlsMatch.d.ts

@@ -1,5 +1,5 @@
 /**
- * Returns true if two URLs have the same `.href` property. The URLS can be
+ * Returns true if two URLs have the same `.href` property. The URLs can be
  * relative, and if they are the current location href is used to resolve URLs.
  *
  * @private

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@serwist/window",
-  "version": "9.0.0-preview.3",
+  "version": "9.0.0-preview.5",
   "type": "module",
   "description": "Simplifies communications with Serwist packages running in the service worker",
   "files": [
@@ -32,12 +32,12 @@
   },
   "dependencies": {
     "@types/trusted-types": "2.0.7",
-    "@serwist/core": "9.0.0-preview.3"
+    "@serwist/core": "9.0.0-preview.5"
   },
   "devDependencies": {
     "rollup": "4.9.6",
     "typescript": "5.4.0-dev.20240206",
-    "@serwist/constants": "9.0.0-preview.3"
+    "@serwist/constants": "9.0.0-preview.5"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0"

package/src/Serwist.ts

@@ -6,7 +6,7 @@
   https://opensource.org/licenses/MIT.
 */
 
-import { Deferred, dontWaitFor, logger } from "@serwist/core/internal";
+import { Deferred, logger } from "@serwist/core/internal";
 import type { TrustedScriptURL } from "trusted-types/lib";
 
 import { messageSW } from "./messageSW.js";
@@ -26,7 +26,7 @@ const REGISTRATION_TIMEOUT_DURATION = 60000;
 
 // The de facto standard message that a service worker should be listening for
 // to trigger a call to skipWaiting().
-const SKIP_WAITING_MESSAGE = { type: "SKIP_WAITING" };
+const SKIP_WAITING_MESSAGE = { type: "SKIP_WAITING" } as const;
 
 /**
  * A class to aid in handling service worker registration, updates, and
@@ -63,14 +63,11 @@ export class Serwist extends SerwistEventTarget {
    * options. The script URL and options are the same as those used when
    * calling [navigator.serviceWorker.register(scriptURL, options)](https://developer.mozilla.org/en-US/docs/Web/API/ServiceWorkerContainer/register).
    *
-   * @param scriptURL The service worker script
-   *     associated with this instance. Using a
-   *     [`TrustedScriptURL`](https://web.dev/trusted-types/) is supported.
-   * @param registerOptions The service worker options associated
-   *     with this instance.
+   * @param scriptURL The service worker script associated with this instance. Using a
+   * [`TrustedScriptURL`](https://developer.mozilla.org/en-US/docs/Web/API/TrustedScriptURL) is supported.
+   * @param registerOptions The service worker options associated with this instance.
    */
-  // biome-ignore lint/complexity/noBannedTypes: Unknown reason
-  constructor(scriptURL: string | TrustedScriptURL, registerOptions: {} = {}) {
+  constructor(scriptURL: string | TrustedScriptURL, registerOptions: RegistrationOptions = {}) {
     super();
 
     this._scriptURL = scriptURL;
@@ -100,7 +97,7 @@ export class Serwist extends SerwistEventTarget {
   } = {}): Promise<ServiceWorkerRegistration | undefined> {
     if (process.env.NODE_ENV !== "production") {
       if (this._registrationTime) {
-        logger.error("Cannot re-register a Serwist instance after it has " + "been registered. Create a new instance instead.");
+        logger.error("Cannot re-register a Serwist instance after it has been registered. Create a new instance instead.");
         return;
       }
     }
@@ -114,7 +111,7 @@ export class Serwist extends SerwistEventTarget {
     this._isUpdate = Boolean(navigator.serviceWorker.controller);
 
     // Before registering, attempt to determine if a SW is already controlling
-    // the page, and if that SW script (and version, if specified) matches this
+    // the page and if that SW script (and version, if specified) matches this
     // instance's script.
     this._compatibleControllingSW = this._getControllingSWIfCompatible();
 
@@ -137,25 +134,23 @@ export class Serwist extends SerwistEventTarget {
     // https://developers.google.com/web/fundamentals/primers/service-workers/lifecycle#waiting
     const waitingSW = this._registration.waiting;
     if (waitingSW && urlsMatch(waitingSW.scriptURL, this._scriptURL.toString())) {
-      // Store the waiting SW as the "own" Sw, even if it means overwriting
+      // Store the waiting SW as the "own" SW, even if it means overwriting
       // a compatible controller.
       this._sw = waitingSW;
 
       // Run this in the next microtask, so any code that adds an event
       // listener after awaiting `register()` will get this event.
-      dontWaitFor(
-        Promise.resolve().then(() => {
-          this.dispatchEvent(
-            new SerwistEvent("waiting", {
-              sw: waitingSW,
-              wasWaitingBeforeRegister: true,
-            }),
-          );
-          if (process.env.NODE_ENV !== "production") {
-            logger.warn("A service worker was already waiting to activate " + "before this script was registered...");
-          }
-        }),
-      );
+      void Promise.resolve().then(() => {
+        this.dispatchEvent(
+          new SerwistEvent("waiting", {
+            sw: waitingSW,
+            wasWaitingBeforeRegister: true,
+          }),
+        );
+        if (process.env.NODE_ENV !== "production") {
+          logger.warn("A service worker was already waiting to activate before this script was registered...");
+        }
+      });
     }
 
     // If an "own" SW is already set, resolve the deferred.
@@ -169,12 +164,10 @@ export class Serwist extends SerwistEventTarget {
 
       if (navigator.serviceWorker.controller) {
         if (this._compatibleControllingSW) {
-          logger.debug("A service worker with the same script URL " + "is already controlling this page.");
+          logger.debug("A service worker with the same script URL is already controlling this page.");
         } else {
           logger.debug(
-            "A service worker with a different script URL is " +
-              "currently controlling the page. The browser is now fetching " +
-              "the new script now...",
+            "A service worker with a different script URL is currently controlling the page. The browser is now fetching the new script now...",
           );
         }
       }
@@ -185,7 +178,7 @@ export class Serwist extends SerwistEventTarget {
         return !location.pathname.startsWith(scopeURLBasePath);
       };
       if (currentPageIsOutOfScope()) {
-        logger.warn("The current page is not in scope for the registered " + "service worker. Was this a mistake?");
+        logger.warn("The current page is not in scope for the registered service worker. Was this a mistake?");
       }
     }
 
@@ -201,7 +194,7 @@ export class Serwist extends SerwistEventTarget {
   async update(): Promise<void> {
     if (!this._registration) {
       if (process.env.NODE_ENV !== "production") {
-        logger.error("Cannot update a Serwist instance without " + "being registered. Register the Serwist instance first.");
+        logger.error("Cannot update a Serwist instance without being registered. Register the Serwist instance first.");
       }
       return;
     }
@@ -274,8 +267,7 @@ export class Serwist extends SerwistEventTarget {
    * @returns
    */
   // We might be able to change the 'data' type to Record<string, unknown> in the future.
-  // eslint-disable-next-line @typescript-eslint/ban-types
-  async messageSW(data: object): Promise<any> {
+  async messageSW(data: any): Promise<any> {
     const sw = await this.getSW();
     return messageSW(sw, data);
   }
@@ -370,11 +362,9 @@ export class Serwist extends SerwistEventTarget {
       // If all of the above are false, then we use a time-based heuristic:
       // Any `updatefound` event that occurs long after our registration is
       // assumed to be external.
-      performance.now() > this._registrationTime + REGISTRATION_TIMEOUT_DURATION
-        ? // If any of the above are not true, we assume the update was
-          // triggered by this instance.
-          true
-        : false;
+      performance.now() > this._registrationTime + REGISTRATION_TIMEOUT_DURATION;
+    // If any of the above are not true, we assume the update was
+    // triggered by this instance.
 
     if (updateLikelyTriggeredExternally) {
       this._externalSW = installingSW;
@@ -539,8 +529,6 @@ export class Serwist extends SerwistEventTarget {
    * @param originalEvent
    */
   private readonly _onMessage = async (originalEvent: MessageEvent) => {
-    // Can't change type 'any' of data.
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
     const { data, ports, source } = originalEvent;
 
     // Wait until there's an "own" service worker. This is used to buffer
@@ -556,8 +544,6 @@ export class Serwist extends SerwistEventTarget {
     if (this._ownSWs.has(source as ServiceWorker)) {
       this.dispatchEvent(
         new SerwistEvent("message", {
-          // Can't change type 'any' of data.
-          // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
           data,
           originalEvent,
           ports,

package/src/messageSW.ts

@@ -19,8 +19,7 @@
  * @param data An object to send to the service worker.
  * @returns
  */
-// biome-ignore lint/complexity/noBannedTypes: Better not change type of data.
-function messageSW(sw: ServiceWorker, data: {}): Promise<any> {
+export const messageSW = (sw: ServiceWorker, data: any): Promise<any> => {
   return new Promise((resolve) => {
     const messageChannel = new MessageChannel();
     messageChannel.port1.onmessage = (event: MessageEvent) => {
@@ -28,6 +27,4 @@ function messageSW(sw: ServiceWorker, data: {}): Promise<any> {
     };
     sw.postMessage(data, [messageChannel.port2]);
   });
-}
-
-export { messageSW };
+};

package/src/utils/urlsMatch.ts

@@ -7,7 +7,7 @@
 */
 
 /**
- * Returns true if two URLs have the same `.href` property. The URLS can be
+ * Returns true if two URLs have the same `.href` property. The URLs can be
  * relative, and if they are the current location href is used to resolve URLs.
  *
  * @private