puppeteer/tsconfig.base.json

{
  "compilerOptions": {
    "esModuleInterop": true,
    "allowJs": true,
    "checkJs": true,
    "target": "ESNext",
    "moduleResolution": "node",
    "module": "ESNext",
    "declaration": true,
    "declarationMap": true,
    "resolveJsonModule": true,
    "sourceMap": true
  }
}
chore: vendor Mitt & update project structure (#6209) * chore: vendor Mitt into src/common/third-party As discussed in #6203 we need to vendor our common dependencies in so that when we ship an ESM build all imports point to file paths and do not rely on Node resolution (e.g. a browser does not understand `import mitt from 'mitt'`). 2020-07-14 15:57:29 +00:00			`{`
			`"compilerOptions": {`
			`"esModuleInterop": true,`
			`"allowJs": true,`
			`"checkJs": true,`
			`"target": "ESNext",`
			`"moduleResolution": "node",`
chore(agnostic): Remove use of util.promisify (#6446) In `src/common` we now use `fs.promises.X` which we can dynamically `import`. In a browser environment this code will never run because it's gated on `isNode` (in a future PR we will add tree-shaking to the bundle step such that this code is eliminated). By using `import`, we ensure TypeScript still can track types and give good type information. In `src/node` we continue to use `util.promisify` but that's not a concern as that code explicitly is never run in the browser. 2020-09-28 09:35:35 +00:00			`"module": "ESNext",`
chore: vendor Mitt & update project structure (#6209) * chore: vendor Mitt into src/common/third-party As discussed in #6203 we need to vendor our common dependencies in so that when we ship an ESM build all imports point to file paths and do not rely on Node resolution (e.g. a browser does not understand `import mitt from 'mitt'`). 2020-07-14 15:57:29 +00:00			`"declaration": true,`
			`"declarationMap": true,`
test: use sourcemaps in unit tests (#6485) Introduce the source-map-support package and require it for mocha running unit tests. Turn on the sourceMap option for tsconfig.base.json so that the sourceMappingURL= line is emitted in the generated files. Co-authored-by: Mathias Bynens <mathias@qiwi.be> 2020-11-26 13:51:17 +00:00			`"resolveJsonModule": true,`
feat(types): expose typedefs to consumers (#6745) This PR replaces https://github.com/puppeteer/puppeteer/pull/6289 with a simpler approach to types where we compile them all alongside the compiled code (so for every `foo.js` that is generated, we generate `foo.d.ts`). By default that's not enough, as when you `import puppeteer from 'puppeteer'` in Node land you import `cjs-entry.js`, so we also create `cjs-entry.d.ts` which TypeScript will then pick up. This type file tells TypeScript that the thing that `cjs-entry.js` exposes is an instance of the `Puppeteer` class, which then hooks all the types up. The previous PR (https://github.com/puppeteer/puppeteer/pull/6289) tried to merge all our typedefs into one big file via API Extractor, but this isn't really necessary a good experience for the developer. One important consideration is that you _could_ consider this a breaking change. I'm not sure how likely it is, but it could cause problems for: * Projects that didn't have any type info for Puppeteer and treated all its exports as `any` may now start having legitimate type failures. * Projects that depend on the `@types/puppeteer` package may have issues if they now swap to use this one and the types aren't quite aligned. In addition, once we do ship a release with this change in, it will mean that we have to treat any changes to any type definitions as release-note-worthy, and any breaking changes to type definitions will need to be treated as breaking code changes (nearly always a breaking type def means a breaking change anyway), but it's worth considering that once we expose these typedefs we should treat them as first class citizens of the project just like we would with the actual source code. I also fully expect to have some bugs with our types, or have users create issues/PRs to change our types, but I think that's a good thing and it should settle down. I've tested this locally by creating a new package, linking Puppeteer via `npm link puppeteer` and then checking that VSCode correctly shows me the right things when I use `Go to Definition` on something that comes from the Puppeteer source code. 2021-01-13 09:37:35 +00:00			`"sourceMap": true`
chore: vendor Mitt & update project structure (#6209) * chore: vendor Mitt into src/common/third-party As discussed in #6203 we need to vendor our common dependencies in so that when we ship an ESM build all imports point to file paths and do not rely on Node resolution (e.g. a browser does not understand `import mitt from 'mitt'`). 2020-07-14 15:57:29 +00:00			`}`
			`}`