2021-01-07 11:46:05 -08:00
|
|
|
# class: Logger
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2021-01-07 16:12:25 -08:00
|
|
|
* langs: js
|
2021-01-07 11:46:05 -08:00
|
|
|
|
|
|
|
Playwright generates a lot of logs and they are accessible via the pluggable logger sink.
|
|
|
|
|
|
|
|
```js
|
|
|
|
const { chromium } = require('playwright'); // Or 'firefox' or 'webkit'.
|
|
|
|
|
|
|
|
(async () => {
|
|
|
|
const browser = await chromium.launch({
|
|
|
|
logger: {
|
2024-03-15 19:04:14 +01:00
|
|
|
isEnabled: (name, severity) => name === 'api',
|
2021-01-07 11:46:05 -08:00
|
|
|
log: (name, severity, message, args) => console.log(`${name} ${message}`)
|
|
|
|
}
|
|
|
|
});
|
2023-06-27 11:53:53 +02:00
|
|
|
// ...
|
2021-01-07 11:46:05 -08:00
|
|
|
})();
|
|
|
|
```
|
|
|
|
|
|
|
|
## method: Logger.isEnabled
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2021-01-07 11:46:05 -08:00
|
|
|
- returns: <[boolean]>
|
|
|
|
|
|
|
|
Determines whether sink is interested in the logger with the given name and severity.
|
|
|
|
|
|
|
|
### param: Logger.isEnabled.name
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2021-01-07 11:46:05 -08:00
|
|
|
- `name` <[string]>
|
|
|
|
|
|
|
|
logger name
|
|
|
|
|
|
|
|
### param: Logger.isEnabled.severity
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2022-03-08 16:02:31 -08:00
|
|
|
- `severity` <[LogSeverity]<"verbose"|"info"|"warning"|"error">>
|
2021-01-07 11:46:05 -08:00
|
|
|
|
|
|
|
## method: Logger.log
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2021-01-07 11:46:05 -08:00
|
|
|
|
|
|
|
### param: Logger.log.name
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2021-01-07 11:46:05 -08:00
|
|
|
- `name` <[string]>
|
|
|
|
|
|
|
|
logger name
|
|
|
|
|
|
|
|
### param: Logger.log.severity
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2022-03-08 16:02:31 -08:00
|
|
|
- `severity` <[LogSeverity]<"verbose"|"info"|"warning"|"error">>
|
2021-01-07 11:46:05 -08:00
|
|
|
|
|
|
|
### param: Logger.log.message
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2021-01-07 11:46:05 -08:00
|
|
|
- `message` <[string]|[Error]>
|
|
|
|
|
|
|
|
log message format
|
|
|
|
|
|
|
|
### param: Logger.log.args
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2021-01-07 11:46:05 -08:00
|
|
|
- `args` <[Array]<[Object]>>
|
|
|
|
|
|
|
|
message arguments
|
|
|
|
|
|
|
|
### param: Logger.log.hints
|
2022-07-05 16:24:50 -08:00
|
|
|
* since: v1.8
|
2021-01-07 11:46:05 -08:00
|
|
|
- `hints` <[Object]>
|
2022-04-06 19:02:10 -07:00
|
|
|
- `color` ?<[string]> Optional preferred logger color.
|
2021-01-07 11:46:05 -08:00
|
|
|
|
|
|
|
optional formatting hints
|