happy-dom 7.7.1 → 7.8.0

package/README.md

@@ -1,6 +1,5 @@
 ![Happy DOM Logo](https://github.com/capricorn86/happy-dom/raw/master/docs/happy-dom-logo.jpg)
 
-
 # About
 
 [Happy DOM](https://github.com/capricorn86/happy-dom) is a JavaScript implementation of a web browser without its graphical user interface. It includes many web standards from WHATWG [DOM](https://dom.spec.whatwg.org/) and [HTML](https://html.spec.whatwg.org/multipage/).
@@ -9,7 +8,6 @@ The goal of [Happy DOM](https://github.com/capricorn86/happy-dom) is to emulate
 
 [Happy DOM](https://github.com/capricorn86/happy-dom) focuses heavily on performance and can be used as an alternative to [JSDOM](https://github.com/jsdom/jsdom).
 
-
 ### DOM Features
 
 - Custom Elements (Web Components)
@@ -26,8 +24,6 @@ The goal of [Happy DOM](https://github.com/capricorn86/happy-dom) is to emulate
 
 And much more..
 
-  
-
 ### Works With
 
 - [Google LitHTML](https://lit-html.polymer-project.org)
@@ -40,20 +36,14 @@ And much more..
 
 - [Vue](https://vuejs.org/)
 
-  
-
 # Installation
 
 ```bash
 npm install happy-dom
 ```
 
-
-
 # Usage
 
-
-
 ## Basic Usage
 
 A simple example of how you can use Happy DOM.
@@ -75,8 +65,6 @@ container.appendChild(button);
 console.log(document.body.innerHTML);
 ```
 
-
-
 ## VM Context
 
 The default Window class is a [VM context](https://nodejs.org/api/vm.html#vm_vm_createcontext_sandbox_options). A [VM context](https://nodejs.org/api/vm.html#vm_vm_createcontext_sandbox_options) will execute JavaScript code scoped within the context where the Window instance will be the global object.
@@ -85,9 +73,9 @@ The default Window class is a [VM context](https://nodejs.org/api/vm.html#vm_vm_
 import { Window } from 'happy-dom';
 
 const window = new Window({
-    innerWidth: 1024,
-    innerHeight: 768,
-    url: 'http://localhost:8080'
+	innerWidth: 1024,
+	innerHeight: 768,
+	url: 'http://localhost:8080'
 });
 const document = window.document;
 
@@ -146,9 +134,9 @@ The example below will show you how to setup a Node [VM context](https://nodejs.
 import { Window } from 'happy-dom';
 
 const window = new Window({
-    innerWidth: 1024,
-    innerHeight: 768,
-    url: 'http://localhost:8080'
+	innerWidth: 1024,
+	innerHeight: 768,
+	url: 'http://localhost:8080'
 });
 const document = window.document;
 
@@ -207,19 +195,15 @@ Will output:
 console.log(document.body.querySelector('div').getInnerHTML({ includeShadowRoots: true }));
 ```
 
-
-
 ## Additional Features
 
-Happy DOM exposes two functions that may be useful when working with asynchrounous code.
-
 **whenAsyncComplete()**
 
 Returns a [Promise](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) that is resolved when all async tasks has been completed.
 
 ```javascript
 window.happyDOM.whenAsyncComplete().then(() => {
-    // Do something when all async tasks are completed.
+	// Do something when all async tasks are completed.
 });
 ```
 
@@ -229,7 +213,7 @@ This method will cancel all running async tasks.
 
 ```javascript
 window.setTimeout(() => {
-    // This timeout will be canceled
+	// This timeout will be canceled
 });
 window.happyDOM.cancelAsync();
 ```
@@ -250,7 +234,60 @@ Sets the property `window.innerHeight` and dispatches a "resize" event.
 window.happyDOM.setInnerHeight(768);
 ```
 
+**setURL()**
+
+Sets the property `window.location.href`.
+
+```javascript
+window.happyDOM.setURL('https://localhost:3000');
+```
+
+## Settings
+
+Settings can be sent to the constructor or by setting them on the "window.happyDOM.settings" property.
+
+Set by constructor:
+
+```javascript
+const window = new Window({
+	innerWidth: 1024,
+	innerHeight: 768,
+	url: 'https://localhost:8080',
+	settings: {
+		disableJavaScriptFileLoading: true,
+		disableJavaScriptEvaluation: true,
+		disableCSSFileLoading: true,
+		enableFileSystemHttpRequests: true
+	}
+});
+```
+
+Set by property:
+
+```javascript
+const window = new Window();
+
+window.happyDOM.settings.disableJavaScriptFileLoading = true;
+window.happyDOM.settings.disableJavaScriptEvaluation = true;
+window.happyDOM.settings.disableCSSFileLoading = true;
+window.happyDOM.settings.enableFileSystemHttpRequests = true;
+```
+
+**disableJavaScriptFileLoading**
+
+Set it to "true" to disable JavaScript file loading. Defaults to "false".
+
+**disableJavaScriptEvaluation**
+
+Set it to "true" to completely disable JavaScript evaluation. Defaults to "false".
 
+**disableCSSFileLoading**
+
+Set it to "true" to disable CSS file loading using the HTMLLinkElement. Defaults to "false".
+
+**enableFileSystemHttpRequests**
+
+Set it to "true" to enable file system HTTP requests using XMLHttpRequest. Defaults to "false".
 
 # Performance
 
@@ -268,12 +305,10 @@ window.happyDOM.setInnerHeight(768);
 
 [See how the test was done here](https://github.com/capricorn86/happy-dom-performance-test)
 
-
-
 # Jest
 
 Happy DOM provide with a package called [@happy-dom/jest-environment](https://github.com/capricorn86/happy-dom/tree/master/packages/jest-environment) that makes it possible to use Happy DOM with [Jest](https://jestjs.io/).
 
 # Global Registration
 
-Happy DOM provide with a package called [@happy-dom/global-registrator](https://github.com/capricorn86/happy-dom/tree/master/packages/global-registrator) that can register Happy DOM globally. It makes it possible to use Happy DOM for testing in a Node environment.
+Happy DOM provide with a package called [@happy-dom/global-registrator](https://github.com/capricorn86/happy-dom/tree/master/packages/global-registrator) that can register Happy DOM globally. It makes it possible to use Happy DOM for testing in a Node environment.

package/lib/async-task-manager/AsyncTaskManager.d.ts

@@ -15,7 +15,7 @@ export default class AsyncTaskManager {
      */
     whenComplete(): Promise<void>;
     /**
-     * Cancels all tasks.
+     * Ends all tasks.
      *
      * @param [error] Error.
      */
@@ -35,9 +35,10 @@ export default class AsyncTaskManager {
     /**
      * Starts an async task.
      *
+     * @param abortHandler Abort handler.
      * @returns Task ID.
      */
-    startTask(): number;
+    startTask(abortHandler?: () => void): number;
     /**
      * Ends an async task.
      *
@@ -50,12 +51,6 @@ export default class AsyncTaskManager {
      * @returns Count.
      */
     getTaskCount(): number;
-    /**
-     * Returns the amount of running timers.
-     *
-     * @returns Count.
-     */
-    getTimerCount(): number;
     /**
      * Returns a new task ID.
      *

package/lib/async-task-manager/AsyncTaskManager.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 class AsyncTaskManager {
     constructor() {
-        this.runningTasks = [];
+        this.runningTasks = {};
         this.runningTimers = [];
         this.queue = [];
     }
@@ -25,18 +25,23 @@ class AsyncTaskManager {
         });
     }
     /**
-     * Cancels all tasks.
+     * Ends all tasks.
      *
      * @param [error] Error.
      */
     cancelAll(error) {
-        for (const timerID of this.runningTimers) {
-            global.clearTimeout(timerID);
-        }
+        const runningTimers = this.runningTimers;
+        const runningTasks = this.runningTasks;
         const promises = this.queue;
-        this.runningTasks = [];
+        this.runningTasks = {};
         this.runningTimers = [];
         this.queue = [];
+        for (const timer of runningTimers) {
+            global.clearTimeout(timer);
+        }
+        for (const key of Object.keys(runningTasks)) {
+            runningTasks[key]();
+        }
         for (const promise of promises) {
             if (error) {
                 promise.reject(error);
@@ -64,18 +69,19 @@ class AsyncTaskManager {
         if (index !== -1) {
             this.runningTimers.splice(index, 1);
         }
-        if (!this.runningTasks.length && !this.runningTimers.length) {
+        if (!Object.keys(this.runningTasks).length && !this.runningTimers.length) {
             this.cancelAll();
         }
     }
     /**
      * Starts an async task.
      *
+     * @param abortHandler Abort handler.
      * @returns Task ID.
      */
-    startTask() {
+    startTask(abortHandler) {
         const taskID = this.newTaskID();
-        this.runningTasks.push(taskID);
+        this.runningTasks[taskID] = abortHandler ? abortHandler : () => { };
         return taskID;
     }
     /**
@@ -84,12 +90,11 @@ class AsyncTaskManager {
      * @param taskID Task ID.
      */
     endTask(taskID) {
-        const index = this.runningTasks.indexOf(taskID);
-        if (index !== -1) {
-            this.runningTasks.splice(index, 1);
-        }
-        if (!this.runningTasks.length && !this.runningTimers.length) {
-            this.cancelAll();
+        if (this.runningTasks[taskID]) {
+            delete this.runningTasks[taskID];
+            if (!Object.keys(this.runningTasks).length && !this.runningTimers.length) {
+                this.cancelAll();
+            }
         }
     }
     /**
@@ -98,15 +103,7 @@ class AsyncTaskManager {
      * @returns Count.
      */
     getTaskCount() {
-        return this.runningTasks.length;
-    }
-    /**
-     * Returns the amount of running timers.
-     *
-     * @returns Count.
-     */
-    getTimerCount() {
-        return this.runningTimers.length;
+        return Object.keys(this.runningTasks).length;
     }
     /**
      * Returns a new task ID.

package/lib/async-task-manager/AsyncTaskManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncTaskManager.js","sourceRoot":"","sources":["../../src/async-task-manager/AsyncTaskManager.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AsyncTaskManager.js","sourceRoot":"","sources":["../../src/async-task-manager/AsyncTaskManager.ts"],"names":[],"mappings":"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"}

package/lib/cookie/Cookie.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Cookie.
+ */
+export default class Cookie {
+    private pairs;
+    key: string;
+    value: string;
+    size: number;
+    domain: string;
+    path: string;
+    expriesOrMaxAge: Date;
+    httpOnly: boolean;
+    secure: boolean;
+    sameSite: string;
+    /**
+     * Constructor.
+     *
+     * @param cookie Cookie.
+     */
+    constructor(cookie: string);
+    /**
+     * Returns a raw string of the cookie.
+     */
+    rawString(): string;
+    /**
+     *
+     */
+    cookieString(): string;
+    /**
+     *
+     */
+    isExpired(): boolean;
+    /**
+     *
+     */
+    isHttpOnly(): boolean;
+    /**
+     *
+     */
+    isSecure(): boolean;
+    /**
+     * Parse a cookie string.
+     *
+     * @param cookieString
+     */
+    static parse(cookieString: string): Cookie;
+    /**
+     * Stringify a Cookie object.
+     *
+     * @param cookie
+     */
+    static stringify(cookie: Cookie): string;
+}

package/lib/cookie/Cookie.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const CookiePairRegex = /([^=]+)(?:=([\s\S]*))?/;
+/**
+ * Cookie.
+ */
+class Cookie {
+    /**
+     * Constructor.
+     *
+     * @param cookie Cookie.
+     */
+    constructor(cookie) {
+        this.pairs = {};
+        //
+        this.key = '';
+        this.value = '';
+        this.size = 0;
+        // Optional
+        this.domain = '';
+        this.path = '';
+        this.expriesOrMaxAge = null;
+        this.httpOnly = false;
+        this.secure = false;
+        this.sameSite = '';
+        let match;
+        const parts = cookie.split(';').filter(Boolean);
+        // Part[0] is the key-value pair.
+        match = new RegExp(CookiePairRegex).exec(parts[0]);
+        if (!match) {
+            throw new Error(`Invalid cookie: ${cookie}`);
+        }
+        this.key = match[1].trim();
+        this.value = match[2];
+        // Set key is empty if match[2] is undefined.
+        if (!match[2]) {
+            this.value = this.key;
+            this.key = '';
+        }
+        this.pairs[this.key] = this.value;
+        this.size = this.key.length + this.value.length;
+        // Attribute.
+        for (const part of parts.slice(1)) {
+            match = new RegExp(CookiePairRegex).exec(part);
+            if (!match) {
+                throw new Error(`Invalid cookie: ${part}`);
+            }
+            const key = match[1].trim();
+            const value = match[2];
+            switch (key.toLowerCase()) {
+                case 'expires':
+                    this.expriesOrMaxAge = new Date(value);
+                    break;
+                case 'max-age':
+                    this.expriesOrMaxAge = new Date(parseInt(value, 10) * 1000 + Date.now());
+                    break;
+                case 'domain':
+                    this.domain = value;
+                    break;
+                case 'path':
+                    this.path = value.startsWith('/') ? value : `/${value}`;
+                    break;
+                case 'httponly':
+                    this.httpOnly = true;
+                    break;
+                case 'secure':
+                    this.secure = true;
+                    break;
+                case 'samesite':
+                    this.sameSite = value;
+                    break;
+                default:
+                    continue; // Skip.
+            }
+            // Skip unknown key-value pair.
+            if (['expires', 'max-age', 'domain', 'path', 'httponly', 'secure', 'samesite'].indexOf(key.toLowerCase()) === -1) {
+                continue;
+            }
+            this.pairs[key] = value;
+        }
+    }
+    /**
+     * Returns a raw string of the cookie.
+     */
+    rawString() {
+        return Object.keys(this.pairs)
+            .map((key) => {
+            if (key) {
+                return `${key}=${this.pairs[key]}`;
+            }
+            return this.pairs[key];
+        })
+            .join('; ');
+    }
+    /**
+     *
+     */
+    cookieString() {
+        if (this.key) {
+            return `${this.key}=${this.value}`;
+        }
+        return this.value;
+    }
+    /**
+     *
+     */
+    isExpired() {
+        // If the expries/maxage is set, then determine whether it is expired.
+        if (this.expriesOrMaxAge && this.expriesOrMaxAge.getTime() < Date.now()) {
+            return true;
+        }
+        // If the expries/maxage is not set, it's a session-level cookie that will expire when the browser is closed.
+        // (it's never expired in happy-dom)
+        return false;
+    }
+    /**
+     *
+     */
+    isHttpOnly() {
+        return this.httpOnly;
+    }
+    /**
+     *
+     */
+    isSecure() {
+        return this.secure;
+    }
+    /**
+     * Parse a cookie string.
+     *
+     * @param cookieString
+     */
+    static parse(cookieString) {
+        return new Cookie(cookieString);
+    }
+    /**
+     * Stringify a Cookie object.
+     *
+     * @param cookie
+     */
+    static stringify(cookie) {
+        return cookie.toString();
+    }
+}
+exports.default = Cookie;
+//# sourceMappingURL=Cookie.js.map

package/lib/cookie/Cookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cookie.js","sourceRoot":"","sources":["../../src/cookie/Cookie.ts"],"names":[],"mappings":"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"}

package/lib/cookie/CookieJar.d.ts

@@ -0,0 +1,30 @@
+import Location from 'src/location/Location';
+/**
+ * CookieJar.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cookie.
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie.
+ */
+export default class CookieJar {
+    private cookies;
+    /**
+     * Validate cookie.
+     *
+     * @param cookie
+     */
+    private validateCookie;
+    /**
+     * Set cookie.
+     *
+     * @param cookieString
+     */
+    setCookiesString(cookieString: string): void;
+    /**
+     * Get cookie.
+     *
+     * @param location Location.
+     * @param fromDocument If true, the caller is a document.
+     * @returns Cookie string.
+     */
+    getCookiesString(location: Location, fromDocument: boolean): string;
+}

package/lib/cookie/CookieJar.js

@@ -0,0 +1,84 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Cookie_1 = __importDefault(require("./Cookie"));
+/**
+ * CookieJar.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Cookie.
+ * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie.
+ */
+class CookieJar {
+    constructor() {
+        this.cookies = [];
+    }
+    /**
+     * Validate cookie.
+     *
+     * @param cookie
+     */
+    validateCookie(cookie) {
+        if (cookie.key.toLowerCase().startsWith('__secure-') && !cookie.isSecure()) {
+            return false;
+        }
+        if (cookie.key.toLowerCase().startsWith('__host-') &&
+            (!cookie.isSecure() || cookie.path !== '/' || cookie.domain)) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Set cookie.
+     *
+     * @param cookieString
+     */
+    setCookiesString(cookieString) {
+        if (!cookieString) {
+            return;
+        }
+        const newCookie = new Cookie_1.default(cookieString);
+        if (!this.validateCookie(newCookie)) {
+            return;
+        }
+        this.cookies
+            .filter((cookie) => cookie.key === newCookie.key)
+            .forEach((cookie) => {
+            this.cookies.splice(this.cookies.indexOf(cookie), 1);
+        });
+        this.cookies.push(newCookie);
+    }
+    /**
+     * Get cookie.
+     *
+     * @param location Location.
+     * @param fromDocument If true, the caller is a document.
+     * @returns Cookie string.
+     */
+    getCookiesString(location, fromDocument) {
+        const cookies = this.cookies.filter((cookie) => {
+            // Skip when use document.cookie and the cookie is httponly.
+            if (fromDocument && cookie.isHttpOnly()) {
+                return false;
+            }
+            if (cookie.isExpired()) {
+                return false;
+            }
+            if (cookie.isSecure() && location.protocol !== 'https:') {
+                return false;
+            }
+            if (cookie.domain && !location.hostname.endsWith(cookie.domain)) {
+                return false;
+            }
+            if (cookie.path && !location.pathname.startsWith(cookie.path)) {
+                return false;
+            }
+            // TODO: check SameSite.
+            return true;
+        });
+        return cookies.map((cookie) => cookie.cookieString()).join('; ');
+    }
+}
+exports.default = CookieJar;
+//# sourceMappingURL=CookieJar.js.map

package/lib/cookie/CookieJar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CookieJar.js","sourceRoot":"","sources":["../../src/cookie/CookieJar.ts"],"names":[],"mappings":";;;;;AACA,sDAA8B;AAE9B;;;;;GAKG;AACH,MAAqB,SAAS;IAA9B;QACS,YAAO,GAAa,EAAE,CAAC;IAuEhC,CAAC;IArEA;;;;OAIG;IACK,cAAc,CAAC,MAAc;QACpC,IAAI,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE;YAC3E,OAAO,KAAK,CAAC;SACb;QACD,IACC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAC9C,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,EAC3D;YACD,OAAO,KAAK,CAAC;SACb;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACI,gBAAgB,CAAC,YAAoB;QAC3C,IAAI,CAAC,YAAY,EAAE;YAClB,OAAO;SACP;QACD,MAAM,SAAS,GAAG,IAAI,gBAAM,CAAC,YAAY,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE;YACpC,OAAO;SACP;QACD,IAAI,CAAC,OAAO;aACV,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,KAAK,SAAS,CAAC,GAAG,CAAC;aAChD,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;;OAMG;IACI,gBAAgB,CAAC,QAAkB,EAAE,YAAqB;QAChE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9C,4DAA4D;YAC5D,IAAI,YAAY,IAAI,MAAM,CAAC,UAAU,EAAE,EAAE;gBACxC,OAAO,KAAK,CAAC;aACb;YACD,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE;gBACvB,OAAO,KAAK,CAAC;aACb;YACD,IAAI,MAAM,CAAC,QAAQ,EAAE,IAAI,QAAQ,CAAC,QAAQ,KAAK,QAAQ,EAAE;gBACxD,OAAO,KAAK,CAAC;aACb;YACD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;gBAChE,OAAO,KAAK,CAAC;aACb;YACD,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;gBAC9D,OAAO,KAAK,CAAC;aACb;YACD,wBAAwB;YACxB,OAAO,IAAI,CAAC;QACb,CAAC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;CACD;AAxED,4BAwEC"}

package/lib/event/IEventListener.d.ts

@@ -6,7 +6,7 @@ export default interface IEventListener {
     /**
      * Handles event.
      *
-     * @param type Event type.
+     * @param event Event.
      */
     handleEvent(event: Event): void;
 }

package/lib/exception/DOMExceptionNameEnum.d.ts

@@ -8,6 +8,9 @@ declare enum DOMExceptionNameEnum {
     invalidNodeTypeError = "InvalidNodeTypeError",
     invalidCharacterError = "InvalidCharacterError",
     notFoundError = "NotFoundError",
-    domException = "DOMException"
+    securityError = "SecurityError",
+    networkError = "NetworkError",
+    domException = "DOMException",
+    invalidAccessError = "InvalidAccessError"
 }
 export default DOMExceptionNameEnum;