From e154176b7cc397399ccb939b920b308f8d5cb874 Mon Sep 17 00:00:00 2001 From: cjihrig Date: Thu, 7 Feb 2019 13:20:32 -0500 Subject: [PATCH] report: rename setDiagnosticReportOptions() setDiagnosticReportOptions() is a method on process.report, making the "DiagnosticReport" part redundant. Rename the function to setOptions(). PR-URL: https://github.com/nodejs/node/pull/25990 Reviewed-By: Richard Lau Reviewed-By: Anna Henningsen --- doc/api/process.md | 19 +++++++------------ doc/api/report.md | 10 +++++----- lib/internal/process/report.js | 2 +- 3 files changed, 13 insertions(+), 18 deletions(-) diff --git a/doc/api/process.md b/doc/api/process.md index 7fb503d74f6505..b87223b9c41289 100644 --- a/doc/api/process.md +++ b/doc/api/process.md @@ -1687,7 +1687,7 @@ console.log(data); Additional documentation is available in the [report documentation][]. -### process.report.setDiagnosticReportOptions([options]); +### process.report.setOptions([options]); @@ -1712,23 +1712,18 @@ are shown below. ```js // Trigger a report on uncaught exceptions or fatal errors. -process.report.setDiagnosticReportOptions({ - events: ['exception', 'fatalerror'] -}); +process.report.setOptions({ events: ['exception', 'fatalerror'] }); // Change the default path and filename of the report. -process.report.setDiagnosticReportOptions({ - filename: 'foo.json', - path: '/home' -}); +process.report.setOptions({ filename: 'foo.json', path: '/home' }); // Produce the report onto stdout, when generated. Special meaning is attached // to `stdout` and `stderr`. Usage of these will result in report being written // to the associated standard streams. URLs are not supported. -process.report.setDiagnosticReportOptions({ filename: 'stdout' }); +process.report.setOptions({ filename: 'stdout' }); // Enable verbose option on report generation. -process.report.setDiagnosticReportOptions({ verbose: true }); +process.report.setOptions({ verbose: true }); ``` Signal based report generation is not supported on Windows. @@ -1742,8 +1737,8 @@ added: v11.8.0 * `filename` {string} Name of the file where the report is written. This should be a relative path, that will be appended to the directory specified in - `process.report.setDiagnosticReportOptions`, or the current working directory - of the Node.js process, if unspecified. + `process.report.setOptions`, or the current working directory of the Node.js + process, if unspecified. * `err` {Error} A custom error used for reporting the JavsScript stack. * Returns: {string} Returns the filename of the generated report. diff --git a/doc/api/report.md b/doc/api/report.md index 3937f88cc1be4a..89bb203691f7c9 100644 --- a/doc/api/report.md +++ b/doc/api/report.md @@ -445,10 +445,10 @@ times for the same Node.js process. ## Configuration Additional runtime configuration that influences the report generation -constraints are available using `setDiagnosticReportOptions()` API. +constraints are available using `setOptions()` API. ```js -process.report.setDiagnosticReportOptions({ +process.report.setOptions({ events: ['exception', 'fatalerror', 'signal'], signal: 'SIGUSR2', filename: 'myreport.json', @@ -481,13 +481,13 @@ pertinent to the report generation. Defaults to `false`. ```js // Trigger report only on uncaught exceptions. -process.report.setDiagnosticReportOptions({ events: ['exception'] }); +process.report.setOptions({ events: ['exception'] }); // Trigger report for both internal errors as well as external signal. -process.report.setDiagnosticReportOptions({ events: ['fatalerror', 'signal'] }); +process.report.setOptions({ events: ['fatalerror', 'signal'] }); // Change the default signal to `SIGQUIT` and enable it. -process.report.setDiagnosticReportOptions( +process.report.setOptions( { events: ['signal'], signal: 'SIGQUIT' }); ``` diff --git a/lib/internal/process/report.js b/lib/internal/process/report.js index 3a0afaf76335dd..95972773b18ecf 100644 --- a/lib/internal/process/report.js +++ b/lib/internal/process/report.js @@ -29,7 +29,7 @@ let config = { verbose: false }; const report = { - setDiagnosticReportOptions(options) { + setOptions(options) { emitExperimentalWarning('report'); const previousConfig = config; const newConfig = {};