happy-dom
Version:
Happy DOM is a JavaScript implementation of a web browser without its graphical user interface. It includes many web standards from WHATWG DOM and HTML.
96 lines • 3.1 kB
JavaScript
;
var __importDefault = (this && this.__importDefault) || function (mod) {
return (mod && mod.__esModule) ? mod : { "default": mod };
};
Object.defineProperty(exports, "__esModule", { value: true });
const BrowserContext_js_1 = __importDefault(require("./BrowserContext.cjs"));
const BrowserSettingsFactory_js_1 = __importDefault(require("./BrowserSettingsFactory.cjs"));
/**
* Browser.
*
* Much of the interface for the browser has been taken from Puppeteer and Playwright, so that the API is familiar.
*/
class Browser {
/**
* Constructor.
*
* @param [options] Options.
* @param [options.settings] Browser settings.
* @param [options.console] Console.
*/
constructor(options) {
this.console = options?.console || null;
this.settings = BrowserSettingsFactory_js_1.default.createSettings(options?.settings);
this.contexts = [new BrowserContext_js_1.default(this)];
}
/**
* Returns the default context.
*
* @returns Default context.
*/
get defaultContext() {
if (this.contexts.length === 0) {
throw new Error('No default context. The browser has been closed.');
}
return this.contexts[0];
}
/**
* Aborts all ongoing operations and destroys the browser.
*/
async close() {
await Promise.all(this.contexts.slice().map((context) => context.close()));
this.contexts = [];
}
/**
* Returns a promise that is resolved when all resources has been loaded, fetch has completed, and all async tasks such as timers are complete.
*
* @returns Promise.
*/
async waitUntilComplete() {
if (this.contexts.length === 0) {
throw new Error('No default context. The browser has been closed.');
}
await Promise.all(this.contexts.map((page) => page.waitUntilComplete()));
}
/**
* Aborts all ongoing operations.
*/
abort() {
// Using Promise instead of async/await to prevent microtask
return new Promise((resolve, reject) => {
if (!this.contexts.length) {
resolve();
return;
}
Promise.all(this.contexts.slice().map((context) => context.abort()))
.then(() => resolve())
.catch((error) => reject(error));
});
}
/**
* Creates a new incognito context.
*
* @returns Context.
*/
newIncognitoContext() {
if (this.contexts.length === 0) {
throw new Error('No default context. The browser has been closed.');
}
const context = new BrowserContext_js_1.default(this);
this.contexts.push(context);
return context;
}
/**
* Creates a new page.
*
* @returns Page.
*/
newPage() {
if (this.contexts.length === 0) {
throw new Error('No default context. The browser has been closed.');
}
return this.contexts[0].newPage();
}
}
exports.default = Browser;
//# sourceMappingURL=Browser.cjs.map