mirror of
https://github.com/microsoft/playwright.git
synced 2025-06-26 21:40:17 +00:00
c5bb08c5f2
Most of the troubleshooting.md doc is not relevant any more: - dependencies are maintained and helped with by launch doctor - sandbox is disabled in Chromium by default References #4683
38 lines
1.7 KiB
Markdown
38 lines
1.7 KiB
Markdown
# Troubleshooting
|
|
|
|
<!-- GEN:toc -->
|
|
- [Browser dependencies](#browser-dependencies)
|
|
- [Code transpilation issues](#code-transpilation-issues)
|
|
- [Node.js requirements](#nodejs-requirements)
|
|
* [ReferenceError: URL is not defined](#referenceerror-url-is-not-defined)
|
|
<!-- GEN:stop -->
|
|
|
|
## Browser dependencies
|
|
|
|
Playwright does self-inspection every time it runs to make sure the browsers can be launched successfully. If there are missing
|
|
dependencies, playwright will print instructions to acquire them.
|
|
|
|
We also provide [Ubuntu 18.04 dockerfile](docker/Dockerfile.bionic) and [Ubuntu 20.04 dockerfile](docker/Dockerfile.focal) with the list of Debian dependencies.
|
|
|
|
## Code transpilation issues
|
|
|
|
If you are using a JavaScript transpiler like babel or TypeScript, calling `evaluate()` with an async function might not work. This is because while `playwright` uses `Function.prototype.toString()` to serialize functions while transpilers could be changing the output code in such a way it's incompatible with `playwright`.
|
|
|
|
Some workarounds to this problem would be to instruct the transpiler not to mess up with the code, for example, configure TypeScript to use latest ECMAScript version (`"target": "es2018"`). Another workaround could be using string templates instead of functions:
|
|
|
|
```js
|
|
await page.evaluate(`(async() => {
|
|
console.log('1');
|
|
})()`);
|
|
```
|
|
|
|
## Node.js requirements
|
|
|
|
### ReferenceError: URL is not defined
|
|
|
|
Playwright requires Node.js 10 or higher. Node.js 8 is not supported, and will cause you to receive this error.
|
|
|
|
# Please file an issue
|
|
|
|
Playwright is a new project, and we are watching the issues very closely. As we solve common issues, this document will grow to include the common answers.
|