@stencil/core 4.18.3 → 4.19.0

package/testing/index.js

@@ -1,5 +1,5 @@
 /*!
- Stencil Testing v4.18.3 | MIT Licensed | https://stenciljs.com
+ Stencil Testing v4.19.0 | MIT Licensed | https://stenciljs.com
  */
 "use strict";
 
@@ -1771,6 +1771,7 @@ function createJestPuppeteerEnvironment() {
       if (!this.browser) {
         this.browser = await connectBrowser();
       }
+      await this.closeOpenPages();
       const page = await newBrowserPage(this.browser);
       this.pages.push(page);
       const env2 = process.env;
@@ -1780,7 +1781,7 @@ function createJestPuppeteerEnvironment() {
       return page;
     }
     async closeOpenPages() {
-      await Promise.all(this.pages.map((page) => page.close()));
+      await Promise.all(this.pages.filter((page) => !page.isClosed()).map((page) => page.close()));
       this.pages.length = 0;
     }
     async teardown() {
@@ -3342,6 +3343,26 @@ function toHaveFirstReceivedEventDetail(eventSpy, eventDetail) {
     throw new Error(`event "${eventSpy.eventName}" was not received`);
   }
   const pass = deepEqual(eventSpy.firstEvent.detail, eventDetail);
+  expect(eventSpy.firstEvent.detail).toEqual(eventDetail);
+  return {
+    message: () => `expected event "${eventSpy.eventName}" detail to ${pass ? "not " : ""}equal`,
+    pass
+  };
+}
+function toHaveLastReceivedEventDetail(eventSpy, eventDetail) {
+  if (!eventSpy) {
+    throw new Error(`toHaveLastReceivedEventDetail event spy is null`);
+  }
+  if (typeof eventSpy.then === "function") {
+    throw new Error(`event spy must be a resolved value, not a promise, before it can be tested`);
+  }
+  if (!eventSpy.eventName) {
+    throw new Error(`toHaveLastReceivedEventDetail did not receive an event spy`);
+  }
+  if (!eventSpy.firstEvent) {
+    throw new Error(`event "${eventSpy.eventName}" was not received`);
+  }
+  const pass = deepEqual(eventSpy.lastEvent.detail, eventDetail);
   expect(eventSpy.lastEvent.detail).toEqual(eventDetail);
   return {
     message: () => `expected event "${eventSpy.eventName}" detail to ${pass ? "not " : ""}equal`,
@@ -3567,6 +3588,7 @@ var expectExtend = {
   toHaveReceivedEventDetail,
   toHaveReceivedEventTimes,
   toHaveFirstReceivedEventDetail,
+  toHaveLastReceivedEventDetail,
   toHaveNthReceivedEventDetail,
   toMatchScreenshot
 };
@@ -3586,15 +3608,17 @@ function jestSetupTestFramework() {
   });
   afterEach(async () => {
     var _a, _b, _c, _d, _e, _f;
-    if (global.__CLOSE_OPEN_PAGES__) {
-      await global.__CLOSE_OPEN_PAGES__();
-    }
     (0, import_testing.stopAutoApplyChanges)();
     const bodyNode = (_e = (_d = (_c = (_b = (_a = global.window) == null ? void 0 : _a.document) == null ? void 0 : _b.childNodes) == null ? void 0 : _c[1]) == null ? void 0 : _d.childNodes) == null ? void 0 : _e.find((ref) => ref.nodeName === "BODY");
     (_f = bodyNode == null ? void 0 : bodyNode.childNodes) == null ? void 0 : _f.forEach(removeDomNodes);
     (0, import_mock_doc7.teardownGlobal)(global);
     global.resourcesUrl = "/build";
   });
+  afterAll(async () => {
+    if (global.__CLOSE_OPEN_PAGES__) {
+      await global.__CLOSE_OPEN_PAGES__();
+    }
+  });
   const jasmineEnv = jasmine.getEnv();
   if (jasmineEnv != null) {
     jasmineEnv.addReporter({
@@ -3701,6 +3725,7 @@ function createJestPuppeteerEnvironment2() {
       if (!this.browser) {
         this.browser = await connectBrowser();
       }
+      await this.closeOpenPages();
       const page = await newBrowserPage(this.browser);
       this.pages.push(page);
       const env2 = process.env;
@@ -3710,7 +3735,7 @@ function createJestPuppeteerEnvironment2() {
       return page;
     }
     async closeOpenPages() {
-      await Promise.all(this.pages.map((page) => page.close()));
+      await Promise.all(this.pages.filter((page) => !page.isClosed()).map((page) => page.close()));
       this.pages.length = 0;
     }
     async teardown() {
@@ -4351,6 +4376,26 @@ function toHaveFirstReceivedEventDetail2(eventSpy, eventDetail) {
     throw new Error(`event "${eventSpy.eventName}" was not received`);
   }
   const pass = deepEqual2(eventSpy.firstEvent.detail, eventDetail);
+  expect(eventSpy.firstEvent.detail).toEqual(eventDetail);
+  return {
+    message: () => `expected event "${eventSpy.eventName}" detail to ${pass ? "not " : ""}equal`,
+    pass
+  };
+}
+function toHaveLastReceivedEventDetail2(eventSpy, eventDetail) {
+  if (!eventSpy) {
+    throw new Error(`toHaveLastReceivedEventDetail event spy is null`);
+  }
+  if (typeof eventSpy.then === "function") {
+    throw new Error(`event spy must be a resolved value, not a promise, before it can be tested`);
+  }
+  if (!eventSpy.eventName) {
+    throw new Error(`toHaveLastReceivedEventDetail did not receive an event spy`);
+  }
+  if (!eventSpy.firstEvent) {
+    throw new Error(`event "${eventSpy.eventName}" was not received`);
+  }
+  const pass = deepEqual2(eventSpy.lastEvent.detail, eventDetail);
   expect(eventSpy.lastEvent.detail).toEqual(eventDetail);
   return {
     message: () => `expected event "${eventSpy.eventName}" detail to ${pass ? "not " : ""}equal`,
@@ -4576,6 +4621,7 @@ var expectExtend2 = {
   toHaveReceivedEventDetail: toHaveReceivedEventDetail2,
   toHaveReceivedEventTimes: toHaveReceivedEventTimes2,
   toHaveFirstReceivedEventDetail: toHaveFirstReceivedEventDetail2,
+  toHaveLastReceivedEventDetail: toHaveLastReceivedEventDetail2,
   toHaveNthReceivedEventDetail: toHaveNthReceivedEventDetail2,
   toMatchScreenshot: toMatchScreenshot2
 };
@@ -4595,15 +4641,17 @@ function jestSetupTestFramework2() {
   });
   afterEach(async () => {
     var _a, _b, _c, _d, _e, _f;
-    if (global.__CLOSE_OPEN_PAGES__) {
-      await global.__CLOSE_OPEN_PAGES__();
-    }
     (0, import_testing2.stopAutoApplyChanges)();
     const bodyNode = (_e = (_d = (_c = (_b = (_a = global.window) == null ? void 0 : _a.document) == null ? void 0 : _b.childNodes) == null ? void 0 : _c[1]) == null ? void 0 : _d.childNodes) == null ? void 0 : _e.find((ref) => ref.nodeName === "BODY");
     (_f = bodyNode == null ? void 0 : bodyNode.childNodes) == null ? void 0 : _f.forEach(removeDomNodes2);
     (0, import_mock_doc12.teardownGlobal)(global);
     global.resourcesUrl = "/build";
   });
+  afterAll(async () => {
+    if (global.__CLOSE_OPEN_PAGES__) {
+      await global.__CLOSE_OPEN_PAGES__();
+    }
+  });
   global.screenshotDescriptions = /* @__PURE__ */ new Set();
   const env2 = process.env;
   if (typeof env2.__STENCIL_DEFAULT_TIMEOUT__ === "string") {
@@ -4701,6 +4749,7 @@ function createJestPuppeteerEnvironment3() {
       if (!this.browser) {
         this.browser = await connectBrowser();
       }
+      await this.closeOpenPages();
       const page = await newBrowserPage(this.browser);
       this.pages.push(page);
       const env2 = process.env;
@@ -4710,7 +4759,7 @@ function createJestPuppeteerEnvironment3() {
       return page;
     }
     async closeOpenPages() {
-      await Promise.all(this.pages.map((page) => page.close()));
+      await Promise.all(this.pages.filter((page) => !page.isClosed()).map((page) => page.close()));
       this.pages.length = 0;
     }
     async teardown() {
@@ -5351,6 +5400,26 @@ function toHaveFirstReceivedEventDetail3(eventSpy, eventDetail) {
     throw new Error(`event "${eventSpy.eventName}" was not received`);
   }
   const pass = deepEqual3(eventSpy.firstEvent.detail, eventDetail);
+  expect(eventSpy.firstEvent.detail).toEqual(eventDetail);
+  return {
+    message: () => `expected event "${eventSpy.eventName}" detail to ${pass ? "not " : ""}equal`,
+    pass
+  };
+}
+function toHaveLastReceivedEventDetail3(eventSpy, eventDetail) {
+  if (!eventSpy) {
+    throw new Error(`toHaveLastReceivedEventDetail event spy is null`);
+  }
+  if (typeof eventSpy.then === "function") {
+    throw new Error(`event spy must be a resolved value, not a promise, before it can be tested`);
+  }
+  if (!eventSpy.eventName) {
+    throw new Error(`toHaveLastReceivedEventDetail did not receive an event spy`);
+  }
+  if (!eventSpy.firstEvent) {
+    throw new Error(`event "${eventSpy.eventName}" was not received`);
+  }
+  const pass = deepEqual3(eventSpy.lastEvent.detail, eventDetail);
   expect(eventSpy.lastEvent.detail).toEqual(eventDetail);
   return {
     message: () => `expected event "${eventSpy.eventName}" detail to ${pass ? "not " : ""}equal`,
@@ -5576,6 +5645,7 @@ var expectExtend3 = {
   toHaveReceivedEventDetail: toHaveReceivedEventDetail3,
   toHaveReceivedEventTimes: toHaveReceivedEventTimes3,
   toHaveFirstReceivedEventDetail: toHaveFirstReceivedEventDetail3,
+  toHaveLastReceivedEventDetail: toHaveLastReceivedEventDetail3,
   toHaveNthReceivedEventDetail: toHaveNthReceivedEventDetail3,
   toMatchScreenshot: toMatchScreenshot3
 };
@@ -5595,15 +5665,17 @@ function jestSetupTestFramework3() {
   });
   afterEach(async () => {
     var _a, _b, _c, _d, _e, _f;
-    if (global.__CLOSE_OPEN_PAGES__) {
-      await global.__CLOSE_OPEN_PAGES__();
-    }
     (0, import_testing3.stopAutoApplyChanges)();
     const bodyNode = (_e = (_d = (_c = (_b = (_a = global.window) == null ? void 0 : _a.document) == null ? void 0 : _b.childNodes) == null ? void 0 : _c[1]) == null ? void 0 : _d.childNodes) == null ? void 0 : _e.find((ref) => ref.nodeName === "BODY");
     (_f = bodyNode == null ? void 0 : bodyNode.childNodes) == null ? void 0 : _f.forEach(removeDomNodes3);
     (0, import_mock_doc17.teardownGlobal)(global);
     global.resourcesUrl = "/build";
   });
+  afterAll(async () => {
+    if (global.__CLOSE_OPEN_PAGES__) {
+      await global.__CLOSE_OPEN_PAGES__();
+    }
+  });
   global.screenshotDescriptions = /* @__PURE__ */ new Set();
   const env2 = process.env;
   if (typeof env2.__STENCIL_DEFAULT_TIMEOUT__ === "string") {
@@ -6684,7 +6756,7 @@ var validateRollupConfig = (config) => {
   if (rollupConfig.inputOptions && isObject(rollupConfig.inputOptions)) {
     cleanRollupConfig = {
       ...cleanRollupConfig,
-      inputOptions: pluck(rollupConfig.inputOptions, ["context", "moduleContext", "treeshake"])
+      inputOptions: pluck(rollupConfig.inputOptions, ["context", "moduleContext", "treeshake", "external"])
     };
   }
   if (rollupConfig.outputOptions && isObject(rollupConfig.outputOptions)) {
@@ -6954,6 +7026,7 @@ var validateConfig = (userConfig = {}, bootstrapConfig) => {
     devMode,
     extras: config.extras || {},
     flags,
+    generateExportMaps: isBoolean(config.generateExportMaps) ? config.generateExportMaps : false,
     hashFileNames,
     hashedFileNameLength: (_c = config.hashedFileNameLength) != null ? _c : DEFAULT_HASHED_FILENAME_LENGTH,
     hydratedFlag: validateHydrated(config),
@@ -9714,6 +9787,9 @@ var E2EElement = class extends import_mock_doc19.MockHTMLElement {
     }
     const frag = (0, import_mock_doc19.parseHtmlToFragment)(outerHTML);
     const rootElm = frag.firstElementChild;
+    if (!rootElm) {
+      return;
+    }
     this.nodeName = rootElm.nodeName;
     this.attributes = (0, import_mock_doc19.cloneAttributes)(rootElm.attributes);
     while (this.childNodes.length > 0) {
@@ -10152,6 +10228,7 @@ function createPuppeteerScreenshotOptions(opts, { width, height }) {
     encoding: "binary"
   };
   if (opts.clip) {
+    puppeteerOpts.captureBeyondViewport = typeof opts.captureBeyondViewport === "boolean" ? opts.captureBeyondViewport : true;
     puppeteerOpts.clip = {
       x: opts.clip.x,
       y: opts.clip.y,
@@ -10159,6 +10236,7 @@ function createPuppeteerScreenshotOptions(opts, { width, height }) {
       height: opts.clip.height
     };
   } else {
+    puppeteerOpts.captureBeyondViewport = typeof opts.captureBeyondViewport === "boolean" ? opts.captureBeyondViewport : false;
     puppeteerOpts.clip = {
       x: 0,
       y: 0,
@@ -10257,6 +10335,7 @@ async function newE2EPage(opts = {}) {
     };
     const failOnConsoleError = opts.failOnConsoleError === true;
     const failOnNetworkError = opts.failOnNetworkError === true;
+    const logFailingNetworkRequests = typeof opts.logFailingNetworkRequests === "boolean" ? opts.logFailingNetworkRequests : true;
     page.on("console", (ev) => {
       if (ev.type() === "error") {
         diagnostics.push({
@@ -10286,7 +10365,7 @@ async function newE2EPage(opts = {}) {
       });
       if (failOnNetworkError) {
         throw new Error(req.failure().errorText);
-      } else {
+      } else if (logFailingNetworkRequests) {
         console.error("requestfailed", req.url());
       }
     });
@@ -10508,7 +10587,7 @@ var getBuildFeatures = (cmps) => {
     member: cmps.some((c) => c.hasMember),
     method: cmps.some((c) => c.hasMethod),
     mode: cmps.some((c) => c.hasMode),
-    observeAttribute: cmps.some((c) => c.hasAttribute),
+    observeAttribute: cmps.some((c) => c.hasAttribute || c.hasWatchCallback),
     prop: cmps.some((c) => c.hasProp),
     propBoolean: cmps.some((c) => c.hasPropBoolean),
     propNumber: cmps.some((c) => c.hasPropNumber),

package/testing/jest/jest-27-and-under/matchers/events.d.ts

@@ -15,6 +15,10 @@ export declare function toHaveFirstReceivedEventDetail(eventSpy: d.EventSpy, eve
     message: () => string;
     pass: boolean;
 };
+export declare function toHaveLastReceivedEventDetail(eventSpy: d.EventSpy, eventDetail: any): {
+    message: () => string;
+    pass: boolean;
+};
 export declare function toHaveNthReceivedEventDetail(eventSpy: d.EventSpy, index: number, eventDetail: any): {
     message: () => string;
     pass: boolean;

package/testing/jest/jest-27-and-under/matchers/index.d.ts

@@ -1,6 +1,6 @@
 import { toEqualAttribute, toEqualAttributes, toHaveAttribute } from './attributes';
 import { toHaveClass, toHaveClasses, toMatchClasses } from './class-list';
-import { toHaveFirstReceivedEventDetail, toHaveNthReceivedEventDetail, toHaveReceivedEvent, toHaveReceivedEventDetail, toHaveReceivedEventTimes } from './events';
+import { toHaveFirstReceivedEventDetail, toHaveLastReceivedEventDetail, toHaveNthReceivedEventDetail, toHaveReceivedEvent, toHaveReceivedEventDetail, toHaveReceivedEventTimes } from './events';
 import { toEqualHtml, toEqualLightHtml } from './html';
 import { toMatchScreenshot } from './screenshot';
 import { toEqualText } from './text';
@@ -18,6 +18,7 @@ export declare const expectExtend: {
     toHaveReceivedEventDetail: typeof toHaveReceivedEventDetail;
     toHaveReceivedEventTimes: typeof toHaveReceivedEventTimes;
     toHaveFirstReceivedEventDetail: typeof toHaveFirstReceivedEventDetail;
+    toHaveLastReceivedEventDetail: typeof toHaveLastReceivedEventDetail;
     toHaveNthReceivedEventDetail: typeof toHaveNthReceivedEventDetail;
     toMatchScreenshot: typeof toMatchScreenshot;
 };

package/testing/jest/jest-28/matchers/events.d.ts

@@ -15,6 +15,10 @@ export declare function toHaveFirstReceivedEventDetail(eventSpy: d.EventSpy, eve
     message: () => string;
     pass: boolean;
 };
+export declare function toHaveLastReceivedEventDetail(eventSpy: d.EventSpy, eventDetail: any): {
+    message: () => string;
+    pass: boolean;
+};
 export declare function toHaveNthReceivedEventDetail(eventSpy: d.EventSpy, index: number, eventDetail: any): {
     message: () => string;
     pass: boolean;

package/testing/jest/jest-28/matchers/index.d.ts

@@ -1,6 +1,6 @@
 import { toEqualAttribute, toEqualAttributes, toHaveAttribute } from './attributes';
 import { toHaveClass, toHaveClasses, toMatchClasses } from './class-list';
-import { toHaveFirstReceivedEventDetail, toHaveNthReceivedEventDetail, toHaveReceivedEvent, toHaveReceivedEventDetail, toHaveReceivedEventTimes } from './events';
+import { toHaveFirstReceivedEventDetail, toHaveLastReceivedEventDetail, toHaveNthReceivedEventDetail, toHaveReceivedEvent, toHaveReceivedEventDetail, toHaveReceivedEventTimes } from './events';
 import { toEqualHtml, toEqualLightHtml } from './html';
 import { toMatchScreenshot } from './screenshot';
 import { toEqualText } from './text';
@@ -18,6 +18,7 @@ export declare const expectExtend: {
     toHaveReceivedEventDetail: typeof toHaveReceivedEventDetail;
     toHaveReceivedEventTimes: typeof toHaveReceivedEventTimes;
     toHaveFirstReceivedEventDetail: typeof toHaveFirstReceivedEventDetail;
+    toHaveLastReceivedEventDetail: typeof toHaveLastReceivedEventDetail;
     toHaveNthReceivedEventDetail: typeof toHaveNthReceivedEventDetail;
     toMatchScreenshot: typeof toMatchScreenshot;
 };

package/testing/jest/jest-29/matchers/events.d.ts

@@ -15,6 +15,10 @@ export declare function toHaveFirstReceivedEventDetail(eventSpy: d.EventSpy, eve
     message: () => string;
     pass: boolean;
 };
+export declare function toHaveLastReceivedEventDetail(eventSpy: d.EventSpy, eventDetail: any): {
+    message: () => string;
+    pass: boolean;
+};
 export declare function toHaveNthReceivedEventDetail(eventSpy: d.EventSpy, index: number, eventDetail: any): {
     message: () => string;
     pass: boolean;

package/testing/jest/jest-29/matchers/index.d.ts

@@ -1,6 +1,6 @@
 import { toEqualAttribute, toEqualAttributes, toHaveAttribute } from './attributes';
 import { toHaveClass, toHaveClasses, toMatchClasses } from './class-list';
-import { toHaveFirstReceivedEventDetail, toHaveNthReceivedEventDetail, toHaveReceivedEvent, toHaveReceivedEventDetail, toHaveReceivedEventTimes } from './events';
+import { toHaveFirstReceivedEventDetail, toHaveLastReceivedEventDetail, toHaveNthReceivedEventDetail, toHaveReceivedEvent, toHaveReceivedEventDetail, toHaveReceivedEventTimes } from './events';
 import { toEqualHtml, toEqualLightHtml } from './html';
 import { toMatchScreenshot } from './screenshot';
 import { toEqualText } from './text';
@@ -18,6 +18,7 @@ export declare const expectExtend: {
     toHaveReceivedEventDetail: typeof toHaveReceivedEventDetail;
     toHaveReceivedEventTimes: typeof toHaveReceivedEventTimes;
     toHaveFirstReceivedEventDetail: typeof toHaveFirstReceivedEventDetail;
+    toHaveLastReceivedEventDetail: typeof toHaveLastReceivedEventDetail;
     toHaveNthReceivedEventDetail: typeof toHaveNthReceivedEventDetail;
     toMatchScreenshot: typeof toMatchScreenshot;
 };

package/testing/mocks.d.ts

@@ -1,4 +1,4 @@
-import type { BuildCtx, CompilerCtx, LoadConfigInit, Module, UnvalidatedConfig, ValidatedConfig } from '@stencil/core/internal';
+import type * as d from '@stencil/core/internal';
 import { TestingLogger } from './testing-logger';
 import { TestingSystem } from './testing-sys';
 /**
@@ -8,7 +8,7 @@ import { TestingSystem } from './testing-sys';
  * provided by this function.
  * @returns the mock Stencil configuration
  */
-export declare function mockValidatedConfig(overrides?: Partial<ValidatedConfig>): ValidatedConfig;
+export declare function mockValidatedConfig(overrides?: Partial<d.ValidatedConfig>): d.ValidatedConfig;
 /**
  * Creates a mock instance of a Stencil configuration entity. The mocked configuration has no guarantees around the
  * types/validity of its data.
@@ -16,7 +16,7 @@ export declare function mockValidatedConfig(overrides?: Partial<ValidatedConfig>
  * provided by this function.
  * @returns the mock Stencil configuration
  */
-export declare function mockConfig(overrides?: Partial<UnvalidatedConfig>): UnvalidatedConfig;
+export declare function mockConfig(overrides?: Partial<d.UnvalidatedConfig>): d.UnvalidatedConfig;
 /**
  * Creates a configuration object used to bootstrap a Stencil task invocation
  *
@@ -27,16 +27,16 @@ export declare function mockConfig(overrides?: Partial<UnvalidatedConfig>): Unva
  * @param overrides the properties on the default entity to manually override
  * @returns the default configuration initialization object, with any overrides applied
  */
-export declare const mockLoadConfigInit: (overrides?: Partial<LoadConfigInit>) => LoadConfigInit;
-export declare function mockCompilerCtx(config?: ValidatedConfig): CompilerCtx;
-export declare function mockBuildCtx(config?: ValidatedConfig, compilerCtx?: CompilerCtx): BuildCtx;
+export declare const mockLoadConfigInit: (overrides?: Partial<d.LoadConfigInit>) => d.LoadConfigInit;
+export declare function mockCompilerCtx(config?: d.ValidatedConfig): d.CompilerCtx;
+export declare function mockBuildCtx(config?: d.ValidatedConfig, compilerCtx?: d.CompilerCtx): d.BuildCtx;
 export declare function mockLogger(): TestingLogger;
 /**
- * Create a {@link CompilerSystem} entity for testing the compiler.
+ * Create a {@link d.CompilerSystem} entity for testing the compiler.
  *
  * This function acts as a thin wrapper around a {@link TestingSystem} entity creation. It exists to provide a logical
  * place in the codebase where we might expect Stencil engineers to reach for when attempting to mock a
- * {@link CompilerSystem} base type. Should there prove to be usage of both this function and the one it wraps,
+ * {@link d.CompilerSystem} base type. Should there prove to be usage of both this function and the one it wraps,
  * reconsider if this wrapper is necessary.
  *
  * @returns a System instance for testing purposes.
@@ -52,4 +52,4 @@ export declare function mockWindow(html?: string): Window;
  * @param mod is an override module that you can supply to set particular values
  * @returns a module object ready to use in tests!
  */
-export declare const mockModule: (mod?: Partial<Module>) => Module;
+export declare const mockModule: (mod?: Partial<d.Module>) => d.Module;

package/testing/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stencil/core/testing",
-  "version": "4.18.3",
+  "version": "4.19.0",
   "description": "Stencil testing suite.",
   "main": "./index.js",
   "types": "./index.d.ts",

package/testing/puppeteer/puppeteer-declarations.d.ts

@@ -12,8 +12,19 @@ export type PageCloseOptions = {
 export interface NewE2EPageOptions extends WaitForOptions {
     url?: string;
     html?: string;
+    /**
+     * If set to `true`, Stencil will throw an error if a console error occurs
+     */
     failOnConsoleError?: boolean;
+    /**
+     * If set to `true`, Stencil will throw an error if a network request fails
+     */
     failOnNetworkError?: boolean;
+    /**
+     * If set to `true`, Stencil will log failing network requests
+     * @default true
+     */
+    logFailingNetworkRequests?: boolean;
 }
 type Omit<T, K> = Pick<T, Exclude<keyof T, K>>;
 type PuppeteerPage = Omit<Page, 'bringToFront' | 'browser' | 'screenshot' | 'emulate' | 'emulateMedia' | 'frames' | 'goBack' | 'goForward' | 'isClosed' | 'mainFrame' | 'pdf' | 'reload' | 'target' | 'title' | 'viewport' | 'waitForNavigation' | 'screenshot' | 'workers' | 'addListener' | 'prependListener' | 'prependOnceListener' | 'removeAllListeners' | 'setMaxListeners' | 'getMaxListeners' | 'listeners' | 'rawListeners' | 'emit' | 'eventNames' | 'listenerCount' | '$x' | 'waitForXPath'>;