From c2f884b369e6b006a8bb95e0ac9814a730aa3c37 Mon Sep 17 00:00:00 2001 From: h7lin Date: Sun, 18 Oct 2020 20:50:51 +0800 Subject: [PATCH] feat: 14.14.0 --- ...ssert_deepequal_actual_expected_message.md | 16 +- ...deepstrictequal_actual_expected_message.md | 13 +- .../assert_doesnotthrow_fn_error_message.md | 4 +- ...rt_notdeepequal_actual_expected_message.md | 16 +- ...deepstrictequal_actual_expected_message.md | 13 +- ..._notstrictequal_actual_expected_message.md | 3 +- ...ert_strictequal_actual_expected_message.md | 3 +- assert/strict_assertion_mode.md | 1 + async_hooks/async_hooks_executionasyncid.md | 2 +- buffer/buf_index.md | 4 - .../buf_indexof_value_byteoffset_encoding.md | 4 +- buffer/buf_readbiguint64le_offset.md | 4 +- buffer/buf_slice_start_end.md | 4 +- buffer/buf_writeuint16le_value_offset.md | 4 +- .../static_method_buffer_allocunsafe_size.md | 2 +- ...c_method_buffer_concat_list_totallength.md | 2 + ..._process_execfilesync_file_args_options.md | 4 +- ..._process_spawnsync_command_args_options.md | 4 +- cli/experimental_wasi_unstable_preview1.md | 2 +- ...ir_directory_report_directory_directory.md | 2 +- cli/report_filename_filename.md | 2 +- cli/report_on_fatalerror.md | 2 +- cli/report_on_signal.md | 2 +- cli/report_signal_signal.md | 2 +- cli/report_uncaught_exception.md | 2 +- ...rpublickey_inputencoding_outputencoding.md | 8 +- crypto/keyobject_asymmetrickeytype.md | 4 +- ...01_http_outgoingmessage_prototype_flush.md | 2 +- deprecations/dep0003_writablestate_buffer.md | 4 +- ...p0004_cryptostream_prototype_readystate.md | 4 +- ...dep0006_child_process_options_customfds.md | 2 +- .../dep0009_crypto_pbkdf2_without_digest.md | 2 +- .../dep0010_crypto_createcredentials.md | 2 +- deprecations/dep0011_crypto_credentials.md | 2 +- deprecations/dep0012_domain_dispose.md | 2 +- ...dep0014_fs_read_legacy_string_interface.md | 8 +- ...015_fs_readsync_legacy_string_interface.md | 8 +- deprecations/dep0016_global_root.md | 2 +- ...0019_require_resolved_outside_directory.md | 2 +- deprecations/dep0020_server_connections.md | 2 +- deprecations/dep0021_server_listenfd.md | 2 +- .../dep0023_os_getnetworkinterfaces.md | 2 +- deprecations/dep0025_require_sys.md | 2 +- deprecations/dep0026_util_print.md | 2 +- deprecations/dep0027_util_puts.md | 2 +- deprecations/dep0028_util_debug.md | 2 +- deprecations/dep0029_util_error.md | 2 +- deprecations/dep0032_domain_module.md | 2 +- .../dep0033_eventemitter_listenercount.md | 2 +- .../dep0034_fs_exists_path_callback.md | 4 +- .../dep0035_fs_lchmod_path_mode_callback.md | 2 +- .../dep0036_fs_lchmodsync_path_mode.md | 2 +- ...dep0037_fs_lchown_path_uid_gid_callback.md | 2 +- .../dep0038_fs_lchownsync_path_uid_gid.md | 2 +- deprecations/dep0039_require_extensions.md | 2 +- ..._repl_history_file_environment_variable.md | 2 +- deprecations/dep0042_tls_cryptostream.md | 2 +- deprecations/dep0044_util_isarray.md | 4 +- deprecations/dep0045_util_isboolean.md | 4 +- deprecations/dep0046_util_isbuffer.md | 4 +- deprecations/dep0047_util_isdate.md | 4 +- deprecations/dep0048_util_iserror.md | 4 +- deprecations/dep0049_util_isfunction.md | 4 +- deprecations/dep0050_util_isnull.md | 4 +- .../dep0051_util_isnullorundefined.md | 4 +- deprecations/dep0052_util_isnumber.md | 4 +- deprecations/dep0053_util_isobject.md | 4 +- deprecations/dep0054_util_isprimitive.md | 4 +- deprecations/dep0055_util_isregexp.md | 4 +- deprecations/dep0056_util_isstring.md | 4 +- deprecations/dep0057_util_issymbol.md | 4 +- deprecations/dep0058_util_isundefined.md | 4 +- deprecations/dep0062_node_debug.md | 6 +- .../dep0085_asynchooks_sensitive_api.md | 4 +- .../dep0086_remove_runinasyncidscope.md | 4 +- deprecations/dep0089_require_assert.md | 2 +- ...before_and_asyncresource_emitafter_apis.md | 6 +- deprecations/dep0111_process_binding.md | 6 +- ...rng_crypto_pseudorandombytes_crypto_rng.md | 5 + ...m_open_and_readstream_open_are_internal.md | 1 + ...dep0139_process_umask_with_no_arguments.md | 4 +- ...equest_destroy_instead_of_request_abort.md | 4 +- deprecations/dep0144_module_parent.md | 4 +- .../dep0146_new_crypto_certificate.md | 124 ---------------- .../dep0147_fs_rmdir_path_recursive_true.md | 137 ++++++++++++++++++ dgram/dgram_createsocket_options_callback.md | 12 +- dgram/socket_bind_port_address_callback.md | 3 +- ...msg_offset_length_port_address_callback.md | 6 +- domain/domain.md | 1 + errors/err_feature_unavailable_on_platform.md | 2 +- errors/err_fs_eisdir.md | 4 + errors/err_script_execution_interrupted.md | 4 +- errors/hpe_header_overflow.md | 3 +- events/event_removelistener.md | 4 +- fs/dir_read.md | 2 +- fs/dir_read_callback.md | 2 +- fs/dir_readsync.md | 2 +- fs/dir_symbol_asynciterator.md | 2 +- fs/file_system_flags.md | 2 +- fs/fs_exists_path_callback.md | 2 +- fs/fs_fstat_fd_options_callback.md | 6 +- fs/fs_lstat_path_options_callback.md | 6 +- fs/fs_lstatsync_path_options.md | 6 +- fs/fs_read_fd_options_callback.md | 2 +- fs/fs_readsync_fd_buffer_options.md | 2 +- fs/fs_rm_path_options_callback.md | 25 ++++ fs/fs_rmsync_path_options.md | 22 +++ fs/fs_stat_path_options_callback.md | 6 +- fs/fs_statsync_path_options.md | 6 +- fs/fs_symlink_target_path_type_callback.md | 8 +- fs/fs_symlinksync_target_path_type.md | 8 +- fs/fspromises_rm_path_options.md | 22 +++ http/event_clienterror.md | 18 +-- http/event_upgrade_1.md | 2 +- ...tp_createserver_options_requestlistener.md | 4 +- ...tehead_statuscode_statusmessage_headers.md | 7 +- ...ttp2_connect_authority_options_listener.md | 3 + ...tesecureserver_options_onrequesthandler.md | 3 + ...2_createserver_options_onrequesthandler.md | 11 +- https/class_https_agent.md | 6 +- modules/module_parent.md | 4 +- n-api/n_api_version_matrix.md | 47 ++---- n-api/napi_call_threadsafe_function.md | 9 +- n-api/napi_get_uv_event_loop.md | 2 +- n-api/napi_make_callback.md | 1 + n-api/napi_object_freeze.md | 24 +++ n-api/napi_object_seal.md | 21 +++ n-api/napi_property_attributes.md | 2 +- packages/exports.md | 18 ++- packages/imports.md | 21 +-- packages/name.md | 4 +- packages/subpath_imports.md | 38 +++++ ...export_patterns.md => subpath_patterns.md} | 13 +- packages/type.md | 2 +- ...oputilization_utilization1_utilization2.md | 4 +- perf_hooks/performancenodetiming_idletime.md | 4 +- process/process_execpath.md | 1 + process/process_initgroups_user_extragroup.md | 2 +- process/process_ppid.md | 2 +- process/process_umask.md | 4 +- process/process_versions.md | 6 +- process/signal_events.md | 4 +- .../querystring_parse_str_sep_eq_options.md | 4 +- readline/readline_createinterface_options.md | 4 +- stream/new_stream_readable_options.md | 6 +- stream/readable_read_size.md | 2 +- stream/stream_pipeline_streams_callback.md | 6 +- tls/tls_connect_options_callback.md | 4 +- tracing/trace_events.md | 6 +- url/url_resolve_from_to.md | 4 +- util/class_util_textencoder.md | 2 +- util/new_textdecoder_encoding_options.md | 2 +- util/util_format_format_args.md | 8 +- ..._inspect_object_showhidden_depth_colors.md | 16 +- v8/v8_getheapstatistics.md | 6 +- vm/new_vm_script_code_options.md | 8 +- vm/vm_compilefunction_code_params_options.md | 11 +- worker_threads/new_worker_filename_options.md | 10 +- zlib/class_options.md | 4 +- 159 files changed, 690 insertions(+), 444 deletions(-) create mode 100644 deprecations/dep0147_fs_rmdir_path_recursive_true.md create mode 100644 errors/err_fs_eisdir.md create mode 100644 fs/fs_rm_path_options_callback.md create mode 100644 fs/fs_rmsync_path_options.md create mode 100644 fs/fspromises_rm_path_options.md create mode 100644 n-api/napi_object_freeze.md create mode 100644 n-api/napi_object_seal.md create mode 100644 packages/subpath_imports.md rename packages/{subpath_export_patterns.md => subpath_patterns.md} (76%) diff --git a/assert/assert_deepequal_actual_expected_message.md b/assert/assert_deepequal_actual_expected_message.md index 80b5b69e..4146d545 100644 --- a/assert/assert_deepequal_actual_expected_message.md +++ b/assert/assert_deepequal_actual_expected_message.md @@ -11,17 +11,23 @@ changes: minor comparison adjustments to make the check less surprising. - version: v9.0.0 pr-url: https://github.com/nodejs/node/pull/15001 - description: The `Error` names and messages are now properly compared + description: The `Error` names and messages are now properly compared. - version: v8.0.0 pr-url: https://github.com/nodejs/node/pull/12142 - description: The `Set` and `Map` content is also compared - - version: v6.4.0, v4.7.1 + description: The `Set` and `Map` content is also compared. + - version: + - v6.4.0 + - v4.7.1 pr-url: https://github.com/nodejs/node/pull/8002 description: Typed array slices are handled correctly now. - - version: v6.1.0, v4.5.0 + - version: + - v6.1.0 + - v4.5.0 pr-url: https://github.com/nodejs/node/pull/6432 description: Objects with circular references can be used as inputs now. - - version: v5.10.1, v4.4.3 + - version: + - v5.10.1 + - v4.4.3 pr-url: https://github.com/nodejs/node/pull/5910 description: Handle non-`Uint8Array` typed arrays correctly. --> diff --git a/assert/assert_deepstrictequal_actual_expected_message.md b/assert/assert_deepstrictequal_actual_expected_message.md index cc7a9790..dec0e913 100644 --- a/assert/assert_deepstrictequal_actual_expected_message.md +++ b/assert/assert_deepstrictequal_actual_expected_message.md @@ -11,20 +11,25 @@ changes: comparison. - version: v8.5.0 pr-url: https://github.com/nodejs/node/pull/15001 - description: The `Error` names and messages are now properly compared + description: The `Error` names and messages are now properly compared. - version: v8.0.0 pr-url: https://github.com/nodejs/node/pull/12142 - description: The `Set` and `Map` content is also compared - - version: v6.4.0, v4.7.1 + description: The `Set` and `Map` content is also compared. + - version: + - v6.4.0 + - v4.7.1 pr-url: https://github.com/nodejs/node/pull/8002 description: Typed array slices are handled correctly now. - version: v6.1.0 pr-url: https://github.com/nodejs/node/pull/6432 description: Objects with circular references can be used as inputs now. - - version: v5.10.1, v4.4.3 + - version: + - v5.10.1 + - v4.4.3 pr-url: https://github.com/nodejs/node/pull/5910 description: Handle non-`Uint8Array` typed arrays correctly. --> + * `actual` {any} * `expected` {any} * `message` {string|Error} diff --git a/assert/assert_doesnotthrow_fn_error_message.md b/assert/assert_doesnotthrow_fn_error_message.md index f1c02438..bf9d306f 100644 --- a/assert/assert_doesnotthrow_fn_error_message.md +++ b/assert/assert_doesnotthrow_fn_error_message.md @@ -1,7 +1,9 @@ diff --git a/assert/assert_notdeepstrictequal_actual_expected_message.md b/assert/assert_notdeepstrictequal_actual_expected_message.md index 063a4d2d..58023e83 100644 --- a/assert/assert_notdeepstrictequal_actual_expected_message.md +++ b/assert/assert_notdeepstrictequal_actual_expected_message.md @@ -11,20 +11,25 @@ changes: comparison. - version: v9.0.0 pr-url: https://github.com/nodejs/node/pull/15001 - description: The `Error` names and messages are now properly compared + description: The `Error` names and messages are now properly compared. - version: v8.0.0 pr-url: https://github.com/nodejs/node/pull/12142 - description: The `Set` and `Map` content is also compared - - version: v6.4.0, v4.7.1 + description: The `Set` and `Map` content is also compared. + - version: + - v6.4.0 + - v4.7.1 pr-url: https://github.com/nodejs/node/pull/8002 description: Typed array slices are handled correctly now. - version: v6.1.0 pr-url: https://github.com/nodejs/node/pull/6432 description: Objects with circular references can be used as inputs now. - - version: v5.10.1, v4.4.3 + - version: + - v5.10.1 + - v4.4.3 pr-url: https://github.com/nodejs/node/pull/5910 description: Handle non-`Uint8Array` typed arrays correctly. --> + * `actual` {any} * `expected` {any} * `message` {string|Error} diff --git a/assert/assert_notstrictequal_actual_expected_message.md b/assert/assert_notstrictequal_actual_expected_message.md index 247dd6e1..2002929c 100644 --- a/assert/assert_notstrictequal_actual_expected_message.md +++ b/assert/assert_notstrictequal_actual_expected_message.md @@ -3,8 +3,9 @@ added: v0.1.21 changes: - version: v10.0.0 pr-url: https://github.com/nodejs/node/pull/17003 - description: Used comparison changed from Strict Equality to `Object.is()` + description: Used comparison changed from Strict Equality to `Object.is()`. --> + * `actual` {any} * `expected` {any} * `message` {string|Error} diff --git a/assert/assert_strictequal_actual_expected_message.md b/assert/assert_strictequal_actual_expected_message.md index 92cc367f..edca4953 100644 --- a/assert/assert_strictequal_actual_expected_message.md +++ b/assert/assert_strictequal_actual_expected_message.md @@ -3,8 +3,9 @@ added: v0.1.21 changes: - version: v10.0.0 pr-url: https://github.com/nodejs/node/pull/17003 - description: Used comparison changed from Strict Equality to `Object.is()` + description: Used comparison changed from Strict Equality to `Object.is()`. --> + * `actual` {any} * `expected` {any} * `message` {string|Error} diff --git a/assert/strict_assertion_mode.md b/assert/strict_assertion_mode.md index 1387c18f..f24c9278 100644 --- a/assert/strict_assertion_mode.md +++ b/assert/strict_assertion_mode.md @@ -4,6 +4,7 @@ changes: - version: - v13.9.0 - v12.16.2 + pr-url: https://github.com/nodejs/node/pull/31635 description: 将“严格模式”更改为“严格的断言模式”，将“传统模式”更改为“传统的断言模式”，以避免与更常见的“严格模式”的含义混淆。 - version: v9.9.0 pr-url: https://github.com/nodejs/node/pull/17615 diff --git a/async_hooks/async_hooks_executionasyncid.md b/async_hooks/async_hooks_executionasyncid.md index e4d0af08..d0d0b6e6 100644 --- a/async_hooks/async_hooks_executionasyncid.md +++ b/async_hooks/async_hooks_executionasyncid.md @@ -4,7 +4,7 @@ added: v8.1.0 changes: - version: v8.2.0 pr-url: https://github.com/nodejs/node/pull/13490 - description: Renamed from `currentId` + description: Renamed from `currentId`. --> * Returns: {number} The `asyncId` of the current execution context. Useful to diff --git a/buffer/buf_index.md b/buffer/buf_index.md index a8e9e2c5..3ec9bbcb 100644 --- a/buffer/buf_index.md +++ b/buffer/buf_index.md @@ -1,7 +1,3 @@ - * `index` {integer} diff --git a/buffer/buf_indexof_value_byteoffset_encoding.md b/buffer/buf_indexof_value_byteoffset_encoding.md index ad54ae54..d25f84fe 100644 --- a/buffer/buf_indexof_value_byteoffset_encoding.md +++ b/buffer/buf_indexof_value_byteoffset_encoding.md @@ -4,7 +4,9 @@ changes: - version: v8.0.0 pr-url: https://github.com/nodejs/node/pull/10236 description: The `value` can now be a `Uint8Array`. - - version: v5.7.0, v4.4.0 + - version: + - v5.7.0 + - v4.4.0 pr-url: https://github.com/nodejs/node/pull/4803 description: When `encoding` is being passed, the `byteOffset` parameter is no longer required. diff --git a/buffer/buf_readbiguint64le_offset.md b/buffer/buf_readbiguint64le_offset.md index 834484d8..7e96c4ec 100644 --- a/buffer/buf_readbiguint64le_offset.md +++ b/buffer/buf_readbiguint64le_offset.md @@ -3,7 +3,9 @@ added: - v12.0.0 - v10.20.0 changes: - - version: v14.10.0 + - version: + - v14.10.0 + - v12.19.0 pr-url: https://github.com/nodejs/node/pull/34960 description: This function is also available as `buf.readBigUint64LE()`. --> diff --git a/buffer/buf_slice_start_end.md b/buffer/buf_slice_start_end.md index a366775b..e96e2f4c 100644 --- a/buffer/buf_slice_start_end.md +++ b/buffer/buf_slice_start_end.md @@ -1,7 +1,9 @@ diff --git a/child_process/child_process_spawnsync_command_args_options.md b/child_process/child_process_spawnsync_command_args_options.md index 8ef82bed..78b5353d 100644 --- a/child_process/child_process_spawnsync_command_args_options.md +++ b/child_process/child_process_spawnsync_command_args_options.md @@ -10,7 +10,9 @@ changes: - version: v8.0.0 pr-url: https://github.com/nodejs/node/pull/10653 description: 选项 `input` 可以是 `Uint8Array`。 - - version: v6.2.1, v4.5.0 + - version: + - v6.2.1 + - v4.5.0 pr-url: https://github.com/nodejs/node/pull/6939 description: The `encoding` option can now explicitly be set to `buffer`. - version: v5.7.0 diff --git a/cli/experimental_wasi_unstable_preview1.md b/cli/experimental_wasi_unstable_preview1.md index 27d0cefa..e26345a7 100644 --- a/cli/experimental_wasi_unstable_preview1.md +++ b/cli/experimental_wasi_unstable_preview1.md @@ -6,7 +6,7 @@ changes: - version: v13.6.0 pr-url: https://github.com/nodejs/node/pull/30980 description: changed from `--experimental-wasi-unstable-preview0` to - `--experimental-wasi-unstable-preview1` + `--experimental-wasi-unstable-preview1`. --> Enable experimental WebAssembly System Interface (WASI) support. diff --git a/cli/report_dir_directory_report_directory_directory.md b/cli/report_dir_directory_report_directory_directory.md index 3629cef8..8636d3be 100644 --- a/cli/report_dir_directory_report_directory_directory.md +++ b/cli/report_dir_directory_report_directory_directory.md @@ -7,7 +7,7 @@ changes: - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/27312 description: Changed from `--diagnostic-report-directory` to - `--report-directory` + `--report-directory`. --> Location at which the report will be generated. diff --git a/cli/report_filename_filename.md b/cli/report_filename_filename.md index 225c906a..5a5a48e9 100644 --- a/cli/report_filename_filename.md +++ b/cli/report_filename_filename.md @@ -7,7 +7,7 @@ changes: - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/27312 description: changed from `--diagnostic-report-filename` to - `--report-filename` + `--report-filename`. --> Name of the file to which the report will be written. diff --git a/cli/report_on_fatalerror.md b/cli/report_on_fatalerror.md index 8d3dd003..3bf5a024 100644 --- a/cli/report_on_fatalerror.md +++ b/cli/report_on_fatalerror.md @@ -7,7 +7,7 @@ changes: - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/27312 description: changed from `--diagnostic-report-on-fatalerror` to - `--report-on-fatalerror` + `--report-on-fatalerror`. --> Enables the report to be triggered on fatal errors (internal errors within diff --git a/cli/report_on_signal.md b/cli/report_on_signal.md index 856219c1..c13dac7f 100644 --- a/cli/report_on_signal.md +++ b/cli/report_on_signal.md @@ -7,7 +7,7 @@ changes: - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/27312 description: changed from `--diagnostic-report-on-signal` to - `--report-on-signal` + `--report-on-signal`. --> Enables report to be generated upon receiving the specified (or predefined) diff --git a/cli/report_signal_signal.md b/cli/report_signal_signal.md index 90004202..7162fb9a 100644 --- a/cli/report_signal_signal.md +++ b/cli/report_signal_signal.md @@ -7,7 +7,7 @@ changes: - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/27312 description: changed from `--diagnostic-report-signal` to - `--report-signal` + `--report-signal`. --> Sets or resets the signal for report generation (not supported on Windows). diff --git a/cli/report_uncaught_exception.md b/cli/report_uncaught_exception.md index b25da0c1..8f22e682 100644 --- a/cli/report_uncaught_exception.md +++ b/cli/report_uncaught_exception.md @@ -7,7 +7,7 @@ changes: - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/27312 description: changed from `--diagnostic-report-uncaught-exception` to - `--report-uncaught-exception` + `--report-uncaught-exception`. --> Enables report to be generated on uncaught exceptions. Useful when inspecting diff --git a/crypto/ecdh_computesecret_otherpublickey_inputencoding_outputencoding.md b/crypto/ecdh_computesecret_otherpublickey_inputencoding_outputencoding.md index 3758a7ba..fed1a79b 100644 --- a/crypto/ecdh_computesecret_otherpublickey_inputencoding_outputencoding.md +++ b/crypto/ecdh_computesecret_otherpublickey_inputencoding_outputencoding.md @@ -1,13 +1,13 @@ * `otherPublicKey` {string | Buffer | TypedArray | DataView} diff --git a/crypto/keyobject_asymmetrickeytype.md b/crypto/keyobject_asymmetrickeytype.md index e57c030d..0939dfd2 100644 --- a/crypto/keyobject_asymmetrickeytype.md +++ b/crypto/keyobject_asymmetrickeytype.md @@ -6,14 +6,14 @@ changes: description: Added support for `'dh'`. - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/26960 - description: Added support for `'rsa-pss'` + description: Added support for `'rsa-pss'`. - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/26786 description: This property now returns `undefined` for KeyObject instances of unrecognized type instead of aborting. - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/26774 - description: Added support for `'x25519'` and `'x448'` + description: Added support for `'x25519'` and `'x448'`. - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/26319 description: Added support for `'ed25519'` and `'ed448'`. diff --git a/deprecations/dep0001_http_outgoingmessage_prototype_flush.md b/deprecations/dep0001_http_outgoingmessage_prototype_flush.md index bf3be9a8..6302d2c2 100644 --- a/deprecations/dep0001_http_outgoingmessage_prototype_flush.md +++ b/deprecations/dep0001_http_outgoingmessage_prototype_flush.md @@ -4,8 +4,8 @@ changes: pr-url: https://github.com/nodejs/node/pull/31164 description: End-of-Life. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. - version: v1.6.0 diff --git a/deprecations/dep0003_writablestate_buffer.md b/deprecations/dep0003_writablestate_buffer.md index 1c08444e..840cdcbf 100644 --- a/deprecations/dep0003_writablestate_buffer.md +++ b/deprecations/dep0003_writablestate_buffer.md @@ -2,10 +2,10 @@ changes: - version: v14.0.0 pr-url: https://github.com/nodejs/node/pull/31165 - description: End-of-Life + description: End-of-Life. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. - version: v0.11.15 diff --git a/deprecations/dep0004_cryptostream_prototype_readystate.md b/deprecations/dep0004_cryptostream_prototype_readystate.md index 75122eae..9e810c9a 100644 --- a/deprecations/dep0004_cryptostream_prototype_readystate.md +++ b/deprecations/dep0004_cryptostream_prototype_readystate.md @@ -4,11 +4,11 @@ changes: pr-url: https://github.com/nodejs/node/pull/17882 description: End-of-Life. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. - - version: 0.4.0 + - version: v0.4.0 commit: 9c7f89bf56abd37a796fea621ad2e47dd33d2b82 description: Documentation-only deprecation. --> diff --git a/deprecations/dep0006_child_process_options_customfds.md b/deprecations/dep0006_child_process_options_customfds.md index 7cb47b8c..f0e2c8cd 100644 --- a/deprecations/dep0006_child_process_options_customfds.md +++ b/deprecations/dep0006_child_process_options_customfds.md @@ -4,8 +4,8 @@ changes: pr-url: https://github.com/nodejs/node/pull/25279 description: End-of-Life. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. - version: v0.11.14 diff --git a/deprecations/dep0009_crypto_pbkdf2_without_digest.md b/deprecations/dep0009_crypto_pbkdf2_without_digest.md index cc3b5c4e..a6bc65a3 100644 --- a/deprecations/dep0009_crypto_pbkdf2_without_digest.md +++ b/deprecations/dep0009_crypto_pbkdf2_without_digest.md @@ -2,7 +2,7 @@ changes: - version: v14.0.0 pr-url: https://github.com/nodejs/node/pull/31166 - description: End-of-Life (for `digest === null`) + description: End-of-Life (for `digest === null`). - version: v11.0.0 pr-url: https://github.com/nodejs/node/pull/22861 description: Runtime deprecation (for `digest === null`). diff --git a/deprecations/dep0010_crypto_createcredentials.md b/deprecations/dep0010_crypto_createcredentials.md index cbf82f75..a8f02e2e 100644 --- a/deprecations/dep0010_crypto_createcredentials.md +++ b/deprecations/dep0010_crypto_createcredentials.md @@ -4,8 +4,8 @@ changes: pr-url: https://github.com/nodejs/node/pull/21153 description: End-of-Life. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. - version: v0.11.13 diff --git a/deprecations/dep0011_crypto_credentials.md b/deprecations/dep0011_crypto_credentials.md index a5b84a42..f3700bf0 100644 --- a/deprecations/dep0011_crypto_credentials.md +++ b/deprecations/dep0011_crypto_credentials.md @@ -4,8 +4,8 @@ changes: pr-url: https://github.com/nodejs/node/pull/21153 description: End-of-Life. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. - version: v0.11.13 diff --git a/deprecations/dep0012_domain_dispose.md b/deprecations/dep0012_domain_dispose.md index 865abd88..f824c362 100644 --- a/deprecations/dep0012_domain_dispose.md +++ b/deprecations/dep0012_domain_dispose.md @@ -4,8 +4,8 @@ changes: pr-url: https://github.com/nodejs/node/pull/15412 description: End-of-Life. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. - version: v0.11.7 diff --git a/deprecations/dep0014_fs_read_legacy_string_interface.md b/deprecations/dep0014_fs_read_legacy_string_interface.md index 55148e8b..0ed2a8f7 100644 --- a/deprecations/dep0014_fs_read_legacy_string_interface.md +++ b/deprecations/dep0014_fs_read_legacy_string_interface.md @@ -3,14 +3,14 @@ changes: - version: v8.0.0 pr-url: https://github.com/nodejs/node/pull/9683 description: End-of-Life. - - version: v6.0.0 - pr-url: https://github.com/nodejs/node/pull/4525 - description: Runtime deprecation. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. + - version: v6.0.0 + pr-url: https://github.com/nodejs/node/pull/4525 + description: Runtime deprecation. - version: v0.1.96 commit: c93e0aaf062081db3ec40ac45b3e2c979d5759d6 description: Documentation-only deprecation. diff --git a/deprecations/dep0015_fs_readsync_legacy_string_interface.md b/deprecations/dep0015_fs_readsync_legacy_string_interface.md index 8458f014..abd35599 100644 --- a/deprecations/dep0015_fs_readsync_legacy_string_interface.md +++ b/deprecations/dep0015_fs_readsync_legacy_string_interface.md @@ -3,14 +3,14 @@ changes: - version: v8.0.0 pr-url: https://github.com/nodejs/node/pull/9683 description: End-of-Life. - - version: v6.0.0 - pr-url: https://github.com/nodejs/node/pull/4525 - description: Runtime deprecation. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. + - version: v6.0.0 + pr-url: https://github.com/nodejs/node/pull/4525 + description: Runtime deprecation. - version: v0.1.96 commit: c93e0aaf062081db3ec40ac45b3e2c979d5759d6 description: Documentation-only deprecation. diff --git a/deprecations/dep0016_global_root.md b/deprecations/dep0016_global_root.md index 1e5b31c0..acf143d6 100644 --- a/deprecations/dep0016_global_root.md +++ b/deprecations/dep0016_global_root.md @@ -2,7 +2,7 @@ changes: - version: v14.0.0 pr-url: https://github.com/nodejs/node/pull/31167 - description: End-of-Life + description: End-of-Life. - version: v6.12.0 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. diff --git a/deprecations/dep0019_require_resolved_outside_directory.md b/deprecations/dep0019_require_resolved_outside_directory.md index 1ce4be1a..d3701605 100644 --- a/deprecations/dep0019_require_resolved_outside_directory.md +++ b/deprecations/dep0019_require_resolved_outside_directory.md @@ -4,8 +4,8 @@ changes: pr-url: https://github.com/nodejs/node/pull/26973 description: Removed functionality. - version: - - v4.8.6 - v6.12.0 + - v4.8.6 pr-url: https://github.com/nodejs/node/pull/10116 description: A deprecation code has been assigned. - version: v1.8.1 diff --git a/deprecations/dep0020_server_connections.md b/deprecations/dep0020_server_connections.md index 4cd5082f..0b42c653 100644 --- a/deprecations/dep0020_server_connections.md +++ b/deprecations/dep0020_server_connections.md @@ -1,8 +1,8 @@ diff --git a/deprecations/dep0035_fs_lchmod_path_mode_callback.md b/deprecations/dep0035_fs_lchmod_path_mode_callback.md index b6c64e99..cca24594 100644 --- a/deprecations/dep0035_fs_lchmod_path_mode_callback.md +++ b/deprecations/dep0035_fs_lchmod_path_mode_callback.md @@ -1,8 +1,8 @@ diff --git a/deprecations/dep0045_util_isboolean.md b/deprecations/dep0045_util_isboolean.md index 4f6334d0..ba0d146c 100644 --- a/deprecations/dep0045_util_isboolean.md +++ b/deprecations/dep0045_util_isboolean.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0046_util_isbuffer.md b/deprecations/dep0046_util_isbuffer.md index 86485008..38784328 100644 --- a/deprecations/dep0046_util_isbuffer.md +++ b/deprecations/dep0046_util_isbuffer.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0047_util_isdate.md b/deprecations/dep0047_util_isdate.md index 8ca155cb..e0e6b9da 100644 --- a/deprecations/dep0047_util_isdate.md +++ b/deprecations/dep0047_util_isdate.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0048_util_iserror.md b/deprecations/dep0048_util_iserror.md index 8f825b14..64eda344 100644 --- a/deprecations/dep0048_util_iserror.md +++ b/deprecations/dep0048_util_iserror.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0049_util_isfunction.md b/deprecations/dep0049_util_isfunction.md index 98f79c55..65ffc1a0 100644 --- a/deprecations/dep0049_util_isfunction.md +++ b/deprecations/dep0049_util_isfunction.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0050_util_isnull.md b/deprecations/dep0050_util_isnull.md index d738d6b9..860ebb08 100644 --- a/deprecations/dep0050_util_isnull.md +++ b/deprecations/dep0050_util_isnull.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0051_util_isnullorundefined.md b/deprecations/dep0051_util_isnullorundefined.md index e2b08ef0..56a177e2 100644 --- a/deprecations/dep0051_util_isnullorundefined.md +++ b/deprecations/dep0051_util_isnullorundefined.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0052_util_isnumber.md b/deprecations/dep0052_util_isnumber.md index 2c869bc3..17aef350 100644 --- a/deprecations/dep0052_util_isnumber.md +++ b/deprecations/dep0052_util_isnumber.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0053_util_isobject.md b/deprecations/dep0053_util_isobject.md index e7606705..bafff194 100644 --- a/deprecations/dep0053_util_isobject.md +++ b/deprecations/dep0053_util_isobject.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0054_util_isprimitive.md b/deprecations/dep0054_util_isprimitive.md index 90d2cadf..1f757c6c 100644 --- a/deprecations/dep0054_util_isprimitive.md +++ b/deprecations/dep0054_util_isprimitive.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0055_util_isregexp.md b/deprecations/dep0055_util_isregexp.md index 86ccace5..3a3c1572 100644 --- a/deprecations/dep0055_util_isregexp.md +++ b/deprecations/dep0055_util_isregexp.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0056_util_isstring.md b/deprecations/dep0056_util_isstring.md index 878fa8ac..6bbf09af 100644 --- a/deprecations/dep0056_util_isstring.md +++ b/deprecations/dep0056_util_isstring.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0057_util_issymbol.md b/deprecations/dep0057_util_issymbol.md index 6f8b82a6..a9b80551 100644 --- a/deprecations/dep0057_util_issymbol.md +++ b/deprecations/dep0057_util_issymbol.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0058_util_isundefined.md b/deprecations/dep0058_util_isundefined.md index 280af257..63120ce1 100644 --- a/deprecations/dep0058_util_isundefined.md +++ b/deprecations/dep0058_util_isundefined.md @@ -1,13 +1,13 @@ diff --git a/deprecations/dep0062_node_debug.md b/deprecations/dep0062_node_debug.md index b4a30653..610d29b6 100644 --- a/deprecations/dep0062_node_debug.md +++ b/deprecations/dep0062_node_debug.md @@ -1,11 +1,11 @@ Type: End-of-Life diff --git a/deprecations/dep0085_asynchooks_sensitive_api.md b/deprecations/dep0085_asynchooks_sensitive_api.md index d67b2520..2c9a3e11 100644 --- a/deprecations/dep0085_asynchooks_sensitive_api.md +++ b/deprecations/dep0085_asynchooks_sensitive_api.md @@ -1,11 +1,11 @@ diff --git a/deprecations/dep0086_remove_runinasyncidscope.md b/deprecations/dep0086_remove_runinasyncidscope.md index b7cf8b37..3a97e310 100644 --- a/deprecations/dep0086_remove_runinasyncidscope.md +++ b/deprecations/dep0086_remove_runinasyncidscope.md @@ -1,11 +1,11 @@ diff --git a/deprecations/dep0089_require_assert.md b/deprecations/dep0089_require_assert.md index c026ef61..56f4607f 100644 --- a/deprecations/dep0089_require_assert.md +++ b/deprecations/dep0089_require_assert.md @@ -5,7 +5,7 @@ changes: description: Deprecation revoked. - version: - v9.9.0 - - v10.0.0 + - v8.13.0 pr-url: https://github.com/nodejs/node/pull/17002 description: Documentation-only deprecation. --> diff --git a/deprecations/dep0098_asynchooks_embedder_asyncresource_emitbefore_and_asyncresource_emitafter_apis.md b/deprecations/dep0098_asynchooks_embedder_asyncresource_emitbefore_and_asyncresource_emitafter_apis.md index 6bc50748..97e449ec 100644 --- a/deprecations/dep0098_asynchooks_embedder_asyncresource_emitbefore_and_asyncresource_emitafter_apis.md +++ b/deprecations/dep0098_asynchooks_embedder_asyncresource_emitbefore_and_asyncresource_emitafter_apis.md @@ -2,11 +2,11 @@ changes: - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/26530 - description: End-of-Life + description: End-of-Life. - version: - - v8.12.0 - - v9.6.0 - v10.0.0 + - v9.6.0 + - v8.12.0 pr-url: https://github.com/nodejs/node/pull/18632 description: Runtime deprecation. --> diff --git a/deprecations/dep0111_process_binding.md b/deprecations/dep0111_process_binding.md index 85a361d8..561f9456 100644 --- a/deprecations/dep0111_process_binding.md +++ b/deprecations/dep0111_process_binding.md @@ -1,11 +1,11 @@ Type: Documentation-only (supports [`--pending-deprecation`][]) diff --git a/deprecations/dep0115_crypto_prng_crypto_pseudorandombytes_crypto_rng.md b/deprecations/dep0115_crypto_prng_crypto_pseudorandombytes_crypto_rng.md index 342f477c..0e690431 100644 --- a/deprecations/dep0115_crypto_prng_crypto_pseudorandombytes_crypto_rng.md +++ b/deprecations/dep0115_crypto_prng_crypto_pseudorandombytes_crypto_rng.md @@ -1,3 +1,6 @@ + + + + + Type: Documentation-only (supports [`--pending-deprecation`][]) In recent versions of Node.js, there is no difference between diff --git a/deprecations/dep0135_writestream_open_and_readstream_open_are_internal.md b/deprecations/dep0135_writestream_open_and_readstream_open_are_internal.md index b681b196..472d2f1c 100644 --- a/deprecations/dep0135_writestream_open_and_readstream_open_are_internal.md +++ b/deprecations/dep0135_writestream_open_and_readstream_open_are_internal.md @@ -2,6 +2,7 @@ changes: - version: v13.0.0 pr-url: https://github.com/nodejs/node/pull/29061 + description: Runtime deprecation. --> Type: Runtime diff --git a/deprecations/dep0139_process_umask_with_no_arguments.md b/deprecations/dep0139_process_umask_with_no_arguments.md index 73c51a53..1e6a1ddf 100644 --- a/deprecations/dep0139_process_umask_with_no_arguments.md +++ b/deprecations/dep0139_process_umask_with_no_arguments.md @@ -1,6 +1,8 @@ diff --git a/deprecations/dep0140_use_request_destroy_instead_of_request_abort.md b/deprecations/dep0140_use_request_destroy_instead_of_request_abort.md index 402a3a31..bbccd76c 100644 --- a/deprecations/dep0140_use_request_destroy_instead_of_request_abort.md +++ b/deprecations/dep0140_use_request_destroy_instead_of_request_abort.md @@ -1,6 +1,8 @@ diff --git a/deprecations/dep0144_module_parent.md b/deprecations/dep0144_module_parent.md index 4435f00b..f94c95fc 100644 --- a/deprecations/dep0144_module_parent.md +++ b/deprecations/dep0144_module_parent.md @@ -1,6 +1,8 @@ diff --git a/deprecations/dep0146_new_crypto_certificate.md b/deprecations/dep0146_new_crypto_certificate.md index 94c8a036..eec9bc11 100644 --- a/deprecations/dep0146_new_crypto_certificate.md +++ b/deprecations/dep0146_new_crypto_certificate.md @@ -10,127 +10,3 @@ Type: Documentation-only The [`crypto.Certificate()` constructor][] is deprecated. Use [static methods of `crypto.Certificate()`][] instead. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - diff --git a/deprecations/dep0147_fs_rmdir_path_recursive_true.md b/deprecations/dep0147_fs_rmdir_path_recursive_true.md new file mode 100644 index 00000000..f6f5d21b --- /dev/null +++ b/deprecations/dep0147_fs_rmdir_path_recursive_true.md @@ -0,0 +1,137 @@ + + +Type: Documentation-only + +In future versions of Node.js, `fs.rmdir(path, { recursive: true })` will throw +on nonexistent paths, or when given a file as a target. +Use `fs.rm(path, { recursive: true, force: true })` instead. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/dgram/dgram_createsocket_options_callback.md b/dgram/dgram_createsocket_options_callback.md index dae27ee2..a60a2c93 100644 --- a/dgram/dgram_createsocket_options_callback.md +++ b/dgram/dgram_createsocket_options_callback.md @@ -1,16 +1,16 @@ * `options` {Object} 允许的选项是: diff --git a/dgram/socket_bind_port_address_callback.md b/dgram/socket_bind_port_address_callback.md index 1f04e2e9..35457330 100644 --- a/dgram/socket_bind_port_address_callback.md +++ b/dgram/socket_bind_port_address_callback.md @@ -1,7 +1,8 @@ * `msg` {Buffer|TypedArray|DataView|string|Array} 要发送的消息。 diff --git a/domain/domain.md b/domain/domain.md index fa36e341..577ca2bd 100644 --- a/domain/domain.md +++ b/domain/domain.md @@ -2,6 +2,7 @@ deprecated: v1.4.2 changes: - version: v8.8.0 + pr-url: https://github.com/nodejs/node/pull/15695 description: Any `Promise`s created in VM contexts no longer have a `.domain` property. Their handlers are still executed in the proper domain, however, and `Promise`s created in the main diff --git a/errors/err_feature_unavailable_on_platform.md b/errors/err_feature_unavailable_on_platform.md index b333d2ae..071f653a 100644 --- a/errors/err_feature_unavailable_on_platform.md +++ b/errors/err_feature_unavailable_on_platform.md @@ -5,4 +5,4 @@ added: v14.0.0 Used when a feature that is not available to the current platform which is running Node.js is used. - + diff --git a/errors/err_fs_eisdir.md b/errors/err_fs_eisdir.md new file mode 100644 index 00000000..efa36316 --- /dev/null +++ b/errors/err_fs_eisdir.md @@ -0,0 +1,4 @@ + +Path is a directory. + + diff --git a/errors/err_script_execution_interrupted.md b/errors/err_script_execution_interrupted.md index 1c34ad89..09638f77 100644 --- a/errors/err_script_execution_interrupted.md +++ b/errors/err_script_execution_interrupted.md @@ -1,5 +1,5 @@ -Script execution was interrupted by `SIGINT` (For example, when Ctrl+C was -pressed). +Script execution was interrupted by `SIGINT` (For example, +Ctrl+C was pressed.) diff --git a/errors/hpe_header_overflow.md b/errors/hpe_header_overflow.md index b2a8963a..c8017ab4 100644 --- a/errors/hpe_header_overflow.md +++ b/errors/hpe_header_overflow.md @@ -3,7 +3,8 @@ changes: - version: - v11.4.0 - v10.15.0 - pr-url: https://github.com/nodejs/node/commit/186035243fad247e3955f + commit: 186035243fad247e3955f + pr-url: https://github.com/nodejs-private/node-private/pull/143 description: Max header size in `http_parser` was set to 8KB. --> diff --git a/events/event_removelistener.md b/events/event_removelistener.md index da713da1..cca5d33b 100644 --- a/events/event_removelistener.md +++ b/events/event_removelistener.md @@ -1,7 +1,9 @@ > 稳定性: 0 - 弃用: 改为使用 [`fs.stat()`] 或 [`fs.access()`]。 diff --git a/fs/fs_fstat_fd_options_callback.md b/fs/fs_fstat_fd_options_callback.md index d02fa8c3..eacccabf 100644 --- a/fs/fs_fstat_fd_options_callback.md +++ b/fs/fs_fstat_fd_options_callback.md @@ -1,6 +1,9 @@ * `fd` {integer} diff --git a/fs/fs_lstat_path_options_callback.md b/fs/fs_lstat_path_options_callback.md index 59b7cc97..7776f207 100644 --- a/fs/fs_lstat_path_options_callback.md +++ b/fs/fs_lstat_path_options_callback.md @@ -1,6 +1,9 @@ * `path` {string|Buffer|URL} diff --git a/fs/fs_lstatsync_path_options.md b/fs/fs_lstatsync_path_options.md index 4db5069a..2e9d5071 100644 --- a/fs/fs_lstatsync_path_options.md +++ b/fs/fs_lstatsync_path_options.md @@ -1,13 +1,13 @@ * `path` {string|Buffer|URL} diff --git a/fs/fs_read_fd_options_callback.md b/fs/fs_read_fd_options_callback.md index 38412e6f..f1da01c7 100644 --- a/fs/fs_read_fd_options_callback.md +++ b/fs/fs_read_fd_options_callback.md @@ -4,7 +4,7 @@ changes: - version: v13.11.0 pr-url: https://github.com/nodejs/node/pull/31402 description: Options object can be passed in - to make Buffer, offset, length and position optional + to make Buffer, offset, length and position optional. --> * `fd` {integer} * `options` {Object} diff --git a/fs/fs_readsync_fd_buffer_options.md b/fs/fs_readsync_fd_buffer_options.md index e72f82d3..2236ffcc 100644 --- a/fs/fs_readsync_fd_buffer_options.md +++ b/fs/fs_readsync_fd_buffer_options.md @@ -4,7 +4,7 @@ changes: - version: v14.0.0 pr-url: https://github.com/nodejs/node/pull/32460 description: Options object can be passed in - to make offset, length and position optional + to make offset, length and position optional. --> * `fd` {integer} diff --git a/fs/fs_rm_path_options_callback.md b/fs/fs_rm_path_options_callback.md new file mode 100644 index 00000000..5aac5a7f --- /dev/null +++ b/fs/fs_rm_path_options_callback.md @@ -0,0 +1,25 @@ + + +* `path` {string|Buffer|URL} +* `options` {Object} + * `force` {boolean} When `true`, exceptions will be ignored if `path` does + not exist. **Default:** `false`. + * `maxRetries` {integer} If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or + `EPERM` error is encountered, Node.js will retry the operation with a linear + backoff wait of `retryDelay` milliseconds longer on each try. This option + represents the number of retries. This option is ignored if the `recursive` + option is not `true`. **Default:** `0`. + * `recursive` {boolean} If `true`, perform a recursive removal. In + recursive mode operations are retried on failure. **Default:** `false`. + * `retryDelay` {integer} The amount of time in milliseconds to wait between + retries. This option is ignored if the `recursive` option is not `true`. + **Default:** `100`. +* `callback` {Function} + * `err` {Error} + +Asynchronously removes files and directories (modeled on the standard POSIX `rm` +utility). No arguments other than a possible exception are given to the +completion callback. + diff --git a/fs/fs_rmsync_path_options.md b/fs/fs_rmsync_path_options.md new file mode 100644 index 00000000..d922b727 --- /dev/null +++ b/fs/fs_rmsync_path_options.md @@ -0,0 +1,22 @@ + + +* `path` {string|Buffer|URL} +* `options` {Object} + * `force` {boolean} When `true`, exceptions will be ignored if `path` does + not exist. **Default:** `false`. + * `maxRetries` {integer} If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or + `EPERM` error is encountered, Node.js will retry the operation with a linear + backoff wait of `retryDelay` milliseconds longer on each try. This option + represents the number of retries. This option is ignored if the `recursive` + option is not `true`. **Default:** `0`. + * `recursive` {boolean} If `true`, perform a recursive directory removal. In + recursive mode operations are retried on failure. **Default:** `false`. + * `retryDelay` {integer} The amount of time in milliseconds to wait between + retries. This option is ignored if the `recursive` option is not `true`. + **Default:** `100`. + +Synchronously removes files and directories (modeled on the standard POSIX `rm` +utility). Returns `undefined`. + diff --git a/fs/fs_stat_path_options_callback.md b/fs/fs_stat_path_options_callback.md index 10d3d8ab..423b32dd 100644 --- a/fs/fs_stat_path_options_callback.md +++ b/fs/fs_stat_path_options_callback.md @@ -1,6 +1,9 @@ * `path` {string|Buffer|URL} diff --git a/fs/fs_statsync_path_options.md b/fs/fs_statsync_path_options.md index 1a9cce41..23c14ccd 100644 --- a/fs/fs_statsync_path_options.md +++ b/fs/fs_statsync_path_options.md @@ -1,13 +1,13 @@ * `path` {string|Buffer|URL} diff --git a/fs/fs_symlink_target_path_type_callback.md b/fs/fs_symlink_target_path_type_callback.md index a5893ccf..182c40e2 100644 --- a/fs/fs_symlink_target_path_type_callback.md +++ b/fs/fs_symlink_target_path_type_callback.md @@ -1,15 +1,15 @@ * `target` {string|Buffer|URL} diff --git a/fs/fs_symlinksync_target_path_type.md b/fs/fs_symlinksync_target_path_type.md index 35e1d3d1..f9158705 100644 --- a/fs/fs_symlinksync_target_path_type.md +++ b/fs/fs_symlinksync_target_path_type.md @@ -1,15 +1,15 @@ * `target` {string|Buffer|URL} diff --git a/fs/fspromises_rm_path_options.md b/fs/fspromises_rm_path_options.md new file mode 100644 index 00000000..3cfc1b66 --- /dev/null +++ b/fs/fspromises_rm_path_options.md @@ -0,0 +1,22 @@ + + +* `path` {string|Buffer|URL} +* `options` {Object} + * `force` {boolean} When `true`, exceptions will be ignored if `path` does + not exist. **Default:** `false`. + * `maxRetries` {integer} If an `EBUSY`, `EMFILE`, `ENFILE`, `ENOTEMPTY`, or + `EPERM` error is encountered, Node.js will retry the operation with a linear + backoff wait of `retryDelay` milliseconds longer on each try. This option + represents the number of retries. This option is ignored if the `recursive` + option is not `true`. **Default:** `0`. + * `recursive` {boolean} If `true`, perform a recursive directory removal. In + recursive mode operations are retried on failure. **Default:** `false`. + * `retryDelay` {integer} The amount of time in milliseconds to wait between + retries. This option is ignored if the `recursive` option is not `true`. + **Default:** `100`. + +Removes files and directories (modeled on the standard POSIX `rm` utility). +Resolves the `Promise` with no arguments on success. + diff --git a/http/event_clienterror.md b/http/event_clienterror.md index 981b0c1c..e362d855 100644 --- a/http/event_clienterror.md +++ b/http/event_clienterror.md @@ -1,20 +1,20 @@ * `exception` {Error} diff --git a/http/event_upgrade_1.md b/http/event_upgrade_1.md index caacb417..ea579c5d 100644 --- a/http/event_upgrade_1.md +++ b/http/event_upgrade_1.md @@ -2,7 +2,7 @@ added: v0.1.94 changes: - version: v10.0.0 - pr-url: v10.0.0 + pr-url: https://github.com/nodejs/node/pull/19981 description: Not listening to this event no longer causes the socket to be destroyed if a client sends an Upgrade header. --> diff --git a/http/http_createserver_options_requestlistener.md b/http/http_createserver_options_requestlistener.md index b1cbdf6d..50402cfd 100644 --- a/http/http_createserver_options_requestlistener.md +++ b/http/http_createserver_options_requestlistener.md @@ -10,7 +10,9 @@ changes: - version: v13.3.0 pr-url: https://github.com/nodejs/node/pull/30570 description: 支持 `maxHeaderSize` 选项。 - - version: v9.6.0, v8.12.0 + - version: + - v9.6.0 + - v8.12.0 pr-url: https://github.com/nodejs/node/pull/15752 description: 支持 `options` 参数。 --> diff --git a/http/response_writehead_statuscode_statusmessage_headers.md b/http/response_writehead_statuscode_statusmessage_headers.md index 042dfeee..ca1b069b 100644 --- a/http/response_writehead_statuscode_statusmessage_headers.md +++ b/http/response_writehead_statuscode_statusmessage_headers.md @@ -1,13 +1,18 @@ * `options` {Object} diff --git a/https/class_https_agent.md b/https/class_https_agent.md index f36264c8..75f66103 100644 --- a/https/class_https_agent.md +++ b/https/class_https_agent.md @@ -1,12 +1,12 @@ HTTPS 的 [`Agent`] 对象，类似于 [`http.Agent`]。 diff --git a/modules/module_parent.md b/modules/module_parent.md index 8325086a..d1fd6f51 100644 --- a/modules/module_parent.md +++ b/modules/module_parent.md @@ -1,6 +1,8 @@ > Stability: 0 - Deprecated: Please use [`require.main`][] and diff --git a/n-api/n_api_version_matrix.md b/n-api/n_api_version_matrix.md index b6d11455..dc66589f 100644 --- a/n-api/n_api_version_matrix.md +++ b/n-api/n_api_version_matrix.md @@ -14,46 +14,43 @@ listed as supporting a later version. 1 2 3 - 4 - 5 - 6 - 7 v6.x v6.14.2* - - - - v8.x v8.6.0** v8.10.0* v8.11.2 - v8.16.0 - - - v9.x v9.0.0* v9.3.0* v9.11.0* + + + ≥ v10.x + all releases + all releases + all releases + + + + + - - - + + + + - - - @@ -61,9 +58,6 @@ listed as supporting a later version. - - - @@ -72,20 +66,14 @@ listed as supporting a later version. - - - - + - - - @@ -94,9 +82,6 @@ listed as supporting a later version. - - -
4567
v10.xv10.0.0v10.0.0v10.0.0 v10.16.0 v10.17.0 v10.20.0
v11.xv11.0.0v11.0.0v11.0.0 v11.8.0
v12.x v12.0.0v12.0.0v12.0.0v12.0.0 v12.11.0 v12.17.0v12.19.0
v13.x v13.0.0 v13.0.0v13.0.0v13.0.0v13.0.0
v14.0.0 v14.0.0 v14.0.0v14.0.0v14.0.0v14.0.0 v14.12.0
diff --git a/n-api/napi_call_threadsafe_function.md b/n-api/napi_call_threadsafe_function.md index 0ecd7d80..24e62aae 100644 --- a/n-api/napi_call_threadsafe_function.md +++ b/n-api/napi_call_threadsafe_function.md @@ -5,13 +5,12 @@ napiVersion: 4 changes: - version: v14.5.0 pr-url: https://github.com/nodejs/node/pull/33453 - description: > - Support for `napi_would_deadlock` has been reverted. + description: Support for `napi_would_deadlock` has been reverted. - version: v14.1.0 pr-url: https://github.com/nodejs/node/pull/32689 - description: > - Return `napi_would_deadlock` when called with `napi_tsfn_blocking` from - the main thread or a worker thread and the queue is full. + description: Return `napi_would_deadlock` when called with + `napi_tsfn_blocking` from the main thread or a worker thread + and the queue is full. --> ```c diff --git a/n-api/napi_get_uv_event_loop.md b/n-api/napi_get_uv_event_loop.md index 0dad2c13..2b1fd42a 100644 --- a/n-api/napi_get_uv_event_loop.md +++ b/n-api/napi_get_uv_event_loop.md @@ -1,7 +1,7 @@ diff --git a/n-api/napi_make_callback.md b/n-api/napi_make_callback.md index f351d84a..409b5717 100644 --- a/n-api/napi_make_callback.md +++ b/n-api/napi_make_callback.md @@ -3,6 +3,7 @@ added: v8.0.0 napiVersion: 1 changes: - version: v8.6.0 + pr-url: https://github.com/nodejs/node/pull/15189 description: Added `async_context` parameter. --> diff --git a/n-api/napi_object_freeze.md b/n-api/napi_object_freeze.md new file mode 100644 index 00000000..2713cc35 --- /dev/null +++ b/n-api/napi_object_freeze.md @@ -0,0 +1,24 @@ + + +> Stability: 1 - Experimental + +```c +napi_status napi_object_freeze(napi_env env, + napi_value object); +``` + +* `[in] env`: The environment that the N-API call is invoked under. +* `[in] object`: The object to freeze. + +Returns `napi_ok` if the API succeeded. + +This method freezes a given object. This prevents new properties from +being added to it, existing properties from being removed, prevents +changing the enumerability, configurability, or writability of existing +properties, and prevents the values of existing properties from being changed. +It also prevents the object's prototype from being changed. This is described +in [Section 19.1.2.6](https://tc39.es/ecma262/#sec-object.freeze) of the +ECMA-262 specification. + diff --git a/n-api/napi_object_seal.md b/n-api/napi_object_seal.md new file mode 100644 index 00000000..9d4614a4 --- /dev/null +++ b/n-api/napi_object_seal.md @@ -0,0 +1,21 @@ + + +> Stability: 1 - Experimental + +```c +napi_status napi_object_seal(napi_env env, + napi_value object); +``` + +* `[in] env`: The environment that the N-API call is invoked under. +* `[in] object`: The object to seal. + +Returns `napi_ok` if the API succeeded. + +This method seals a given object. This prevents new properties from being +added to it, as well as marking all existing properties as non-configurable. +This is described in [Section 19.1.2.20](https://tc39.es/ecma262/#sec-object.seal) +of the ECMA-262 specification. + diff --git a/n-api/napi_property_attributes.md b/n-api/napi_property_attributes.md index edde0931..7228cefe 100644 --- a/n-api/napi_property_attributes.md +++ b/n-api/napi_property_attributes.md @@ -2,7 +2,7 @@ changes: - version: v14.12.0 pr-url: https://github.com/nodejs/node/pull/35214 - description: added `napi_default_method` and `napi_default_property` + description: added `napi_default_method` and `napi_default_property`. --> ```c diff --git a/packages/exports.md b/packages/exports.md index 7a957b9b..37f8246c 100644 --- a/packages/exports.md +++ b/packages/exports.md @@ -2,20 +2,24 @@ added: v12.7.0 changes: - version: - - v12.16.0 - - v13.2.0 - pr-url: https://github.com/nodejs/node/pull/29978 - description: Implement conditional exports. + - v14.13.0 + pr-url: https://github.com/nodejs/node/pull/34718 + description: Add support for `"exports"` patterns. - version: + - v13.7.0 - v12.16.0 + pr-url: https://github.com/nodejs/node/pull/31008 + description: Implement logical conditional exports ordering. + - version: - v13.7.0 + - v12.16.0 pr-url: https://github.com/nodejs/node/pull/31001 description: Remove the `--experimental-conditional-exports` option. - version: + - v13.2.0 - v12.16.0 - - v13.7.0 - pr-url: https://github.com/nodejs/node/pull/31008 - description: Implement logical conditional exports ordering. + pr-url: https://github.com/nodejs/node/pull/29978 + description: Implement conditional exports. --> * Type: {Object} | {string} | {string[]} diff --git a/packages/imports.md b/packages/imports.md index 7d79dc74..9c407b46 100644 --- a/packages/imports.md +++ b/packages/imports.md @@ -6,16 +6,6 @@ added: v14.6.0 * Type: {Object} -In addition to the [`"exports"`][] field it is possible to define internal -package import maps that only apply to import specifiers from within the package -itself. - -Entries in the imports field must always start with `#` to ensure they are -clearly disambiguated from package specifiers. - -For example, the imports field can be used to gain the benefits of conditional -exports for internal modules: - ```json // package.json { @@ -31,15 +21,12 @@ exports for internal modules: } ``` -where `import '#dep'` would now get the resolution of the external package -`dep-node-native` (including its exports in turn), and instead get the local -file `./dep-polyfill.js` relative to the package in other environments. +Entries in the imports field must be strings starting with `#`. + +Import maps permit mapping to external packages. -Unlike the `"exports"` field, import maps permit mapping to external packages, -providing an important use case for conditional loading scenarios. +This field defines [subpath imports][] for the current package. -Apart from the above, the resolution rules for the imports field are otherwise -analogous to the exports field. diff --git a/packages/name.md b/packages/name.md index 7a879731..99b1df0a 100644 --- a/packages/name.md +++ b/packages/name.md @@ -1,11 +1,11 @@ diff --git a/packages/subpath_imports.md b/packages/subpath_imports.md new file mode 100644 index 00000000..746e7ed0 --- /dev/null +++ b/packages/subpath_imports.md @@ -0,0 +1,38 @@ + +> Stability: 1 - Experimental + +In addition to the [`"exports"`][] field, it is possible to define internal +package import maps that only apply to import specifiers from within the package +itself. + +Entries in the imports field must always start with `#` to ensure they are +disambiguated from package specifiers. + +For example, the imports field can be used to gain the benefits of conditional +exports for internal modules: + +```json +// package.json +{ + "imports": { + "#dep": { + "node": "dep-node-native", + "default": "./dep-polyfill.js" + } + }, + "dependencies": { + "dep-node-native": "^1.0.0" + } +} +``` + +where `import '#dep'` does not get the resolution of the external package +`dep-node-native` (including its exports in turn), and instead gets the local +file `./dep-polyfill.js` relative to the package in other environments. + +Unlike the `"exports"` field, the `"imports"` field permits mapping to external +packages. + +The resolution rules for the imports field are otherwise +analogous to the exports field. + diff --git a/packages/subpath_export_patterns.md b/packages/subpath_patterns.md similarity index 76% rename from packages/subpath_export_patterns.md rename to packages/subpath_patterns.md index 11d25fb2..9276963a 100644 --- a/packages/subpath_export_patterns.md +++ b/packages/subpath_patterns.md @@ -1,9 +1,10 @@ > Stability: 1 - Experimental -For packages with a small number of exports, we recommend explicitly listing -each exports subpath entry. But for packages that have large numbers of -subpaths, this might cause `package.json` bloat and maintenance issues. +For packages with a small number of exports or imports, we recommend +explicitly listing each exports subpath entry. But for packages that have +large numbers of subpaths, this might cause `package.json` bloat and +maintenance issues. For these use cases, subpath export patterns can be used instead: @@ -12,6 +13,9 @@ For these use cases, subpath export patterns can be used instead: { "exports": { "./features/*": "./src/features/*.js" + }, + "imports": { + "#internal/*": "./src/internal/*.js" } } ``` @@ -26,6 +30,9 @@ import featureX from 'es-module-package/features/x'; import featureY from 'es-module-package/features/y/y'; // Loads ./node_modules/es-module-package/src/features/y/y.js + +import internalZ from '#internal/z'; +// Loads ./node_modules/es-module-package/src/internal/z.js ``` This is a direct static replacement without any special handling for file diff --git a/packages/type.md b/packages/type.md index 91ff87ba..f1bf098f 100644 --- a/packages/type.md +++ b/packages/type.md @@ -2,8 +2,8 @@ added: v12.0.0 changes: - version: - - v12.17.0 - v13.2.0 + - v12.17.0 pr-url: https://github.com/nodejs/node/pull/29866 description: Unflag `--experimental-modules`. --> diff --git a/perf_hooks/performance_eventlooputilization_utilization1_utilization2.md b/perf_hooks/performance_eventlooputilization_utilization1_utilization2.md index df6bfc7b..c9358ae4 100644 --- a/perf_hooks/performance_eventlooputilization_utilization1_utilization2.md +++ b/perf_hooks/performance_eventlooputilization_utilization1_utilization2.md @@ -1,5 +1,7 @@ * `utilization1` {Object} The result of a previous call to diff --git a/perf_hooks/performancenodetiming_idletime.md b/perf_hooks/performancenodetiming_idletime.md index cdf45e4f..c0f5007d 100644 --- a/perf_hooks/performancenodetiming_idletime.md +++ b/perf_hooks/performancenodetiming_idletime.md @@ -1,5 +1,7 @@ * {number} diff --git a/process/process_execpath.md b/process/process_execpath.md index bbca3c6e..64cb2eda 100644 --- a/process/process_execpath.md +++ b/process/process_execpath.md @@ -5,6 +5,7 @@ added: v0.1.100 * {string} `process.execPath` 属性返回启动 Node.js 进程的可执行文件的绝对路径名。 +Symbolic links, if any, are resolved. ```js diff --git a/process/process_initgroups_user_extragroup.md b/process/process_initgroups_user_extragroup.md index b5b46752..1ef174f5 100644 --- a/process/process_initgroups_user_extragroup.md +++ b/process/process_initgroups_user_extragroup.md @@ -12,7 +12,7 @@ added: v0.9.4 ```js console.log(process.getgroups()); // [ 0 ] -process.initgroups('bnoordhuis', 1000); // 切换用户。 +process.initgroups('nodeuser', 1000); // 切换用户。 console.log(process.getgroups()); // [ 27, 30, 46, 1000, 0 ] process.setgid(1000); // 删除 root 的 gid。 console.log(process.getgroups()); // [ 27, 30, 46, 1000 ] diff --git a/process/process_ppid.md b/process/process_ppid.md index 5a87f001..90379873 100644 --- a/process/process_ppid.md +++ b/process/process_ppid.md @@ -7,7 +7,7 @@ added: * {integer} -`process.ppid` 属性返回当前父进程的 PID。 +`process.ppid` 属性返回当前进程的父进程的 PID。 ```js console.log(`父进程的 pid 是 ${process.ppid}`); diff --git a/process/process_umask.md b/process/process_umask.md index 583a6a08..2e71f334 100644 --- a/process/process_umask.md +++ b/process/process_umask.md @@ -1,7 +1,9 @@ * {Object} diff --git a/process/signal_events.md b/process/signal_events.md index affd5e9d..a1dac839 100644 --- a/process/signal_events.md +++ b/process/signal_events.md @@ -35,9 +35,9 @@ process.on('SIGTERM', handle); 可以给其绑定监听器，但是 Windows 下 Node.js 会在它触发后 10 秒钟无条件关闭。 在非 Windows 平台，`SIGHUP` 默认的绑定行为是结束 Node.js，但是一旦给它绑定了新的监听器，默认行为会被移除。 * `'SIGTERM'` 在 Windows 中不支持，可以给其绑定监听器。 -* `'SIGINT'` 在终端运行时，可以被所有平台支持，通常可以通过 `+C` 触发（虽然这是可以配置的）。 +* `'SIGINT'` 在终端运行时，可以被所有平台支持，通常可以通过 Ctrl+C 触发（虽然这是可以配置的）。 当终端运行在原始模式，它不会被触发。 -* `'SIGBREAK'` 在 Windows 中按下 `+` 会被触发，非 Windows 平台中可以为其绑定监听器，但是没有方式触发或发送此事件。 +* `'SIGBREAK'` 在 Windows 中按下 Ctrl+Break 会被触发，非 Windows 平台中可以为其绑定监听器，但是没有方式触发或发送此事件。 * `'SIGWINCH'` 当控制台被调整大小时会触发。Windows 中只有当光标移动并写入到控制台、或者以原始模式使用一个可读 tty 时，才会触发。 * `'SIGKILL'` 不能绑定监听器，所有平台中出现此事件，都会使得 Node.js 无条件终止。 * `'SIGSTOP'` 不能绑定监听器。 diff --git a/querystring/querystring_parse_str_sep_eq_options.md b/querystring/querystring_parse_str_sep_eq_options.md index 85aa463b..4614032d 100644 --- a/querystring/querystring_parse_str_sep_eq_options.md +++ b/querystring/querystring_parse_str_sep_eq_options.md @@ -7,7 +7,9 @@ changes: - version: v6.0.0 pr-url: https://github.com/nodejs/node/pull/6055 description: 返回的对象不再继承自 `Object.prototype`。 - - version: v6.0.0, v4.2.4 + - version: + - v6.0.0 + - v4.2.4 pr-url: https://github.com/nodejs/node/pull/3807 description: 参数 `eq` 现在可以长度大于 `1`。 --> diff --git a/readline/readline_createinterface_options.md b/readline/readline_createinterface_options.md index fe93e082..b63cffcc 100644 --- a/readline/readline_createinterface_options.md +++ b/readline/readline_createinterface_options.md @@ -4,7 +4,9 @@ changes: - version: v13.9.0 pr-url: https://github.com/nodejs/node/pull/31318 description: The `tabSize` option is supported now. - - version: v8.3.0, 6.11.4 + - version: + - v8.3.0 + - v6.11.4 pr-url: https://github.com/nodejs/node/pull/13497 description: Remove max limit of `crlfDelay` option. - version: v6.6.0 diff --git a/stream/new_stream_readable_options.md b/stream/new_stream_readable_options.md index 9411a1a6..669575e0 100644 --- a/stream/new_stream_readable_options.md +++ b/stream/new_stream_readable_options.md @@ -1,14 +1,14 @@ * `options` {Object} diff --git a/stream/readable_read_size.md b/stream/readable_read_size.md index dfb49064..6e2b6e5e 100644 --- a/stream/readable_read_size.md +++ b/stream/readable_read_size.md @@ -14,7 +14,7 @@ added: v0.9.4 如果没有指定 `size` 参数，则返回内部缓冲中的所有数据。 -`size` 参数必须小于或等于 1 GB。 +`size` 参数必须小于或等于 1 GiB。 `readable.read()` 应该只对处于暂停模式的可读流调用。 在流动模式中，`readable.read()` 会自动调用直到内部缓冲的数据完全耗尽。 diff --git a/stream/stream_pipeline_streams_callback.md b/stream/stream_pipeline_streams_callback.md index abc9e0c0..5900619e 100644 --- a/stream/stream_pipeline_streams_callback.md +++ b/stream/stream_pipeline_streams_callback.md @@ -1,15 +1,15 @@ * `streams` {Stream[]|Iterable[]|AsyncIterable[]|Function[]} diff --git a/tls/tls_connect_options_callback.md b/tls/tls_connect_options_callback.md index ebf84d9b..cad5a30e 100644 --- a/tls/tls_connect_options_callback.md +++ b/tls/tls_connect_options_callback.md @@ -30,7 +30,9 @@ changes: pr-url: https://github.com/nodejs/node/pull/11984 description: The `ALPNProtocols` option can be a `TypedArray` or `DataView` now. - - version: v5.3.0, v4.7.0 + - version: + - v5.3.0 + - v4.7.0 pr-url: https://github.com/nodejs/node/pull/4246 description: The `secureContext` option is supported now. - version: v5.0.0 diff --git a/tracing/trace_events.md b/tracing/trace_events.md index a9e71945..31dba4c3 100644 --- a/tracing/trace_events.md +++ b/tracing/trace_events.md @@ -79,9 +79,9 @@ string that supports `${rotation}` and `${pid}`: node --trace-event-categories v8 --trace-event-file-pattern '${pid}-${rotation}.log' server.js ``` -Starting with Node.js 10.0.0, the tracing system uses the same time source -as the one used by `process.hrtime()` -however the trace-event timestamps are expressed in microseconds, +The tracing system uses the same time source +as the one used by `process.hrtime()`. +However the trace-event timestamps are expressed in microseconds, unlike `process.hrtime()` which returns nanoseconds. The features from this module are not available in [`Worker`][] threads. diff --git a/url/url_resolve_from_to.md b/url/url_resolve_from_to.md index 13473358..864de383 100644 --- a/url/url_resolve_from_to.md +++ b/url/url_resolve_from_to.md @@ -8,7 +8,9 @@ changes: pr-url: https://github.com/nodejs/node/pull/8215 description: The `auth` fields are now kept intact when `from` and `to` refer to the same host. - - version: v6.5.0, v4.6.2 + - version: + - v6.5.0 + - v4.6.2 pr-url: https://github.com/nodejs/node/pull/8214 description: The `port` field is copied correctly now. - version: v6.0.0 diff --git a/util/class_util_textencoder.md b/util/class_util_textencoder.md index 457fb5cb..eddbd681 100644 --- a/util/class_util_textencoder.md +++ b/util/class_util_textencoder.md @@ -2,7 +2,7 @@ added: v8.3.0 changes: - version: v11.0.0 - pr-url: v11.0.0 + pr-url: https://github.com/nodejs/node/pull/22281 description: The class is now available on the global object. --> diff --git a/util/new_textdecoder_encoding_options.md b/util/new_textdecoder_encoding_options.md index a725d803..98528d03 100644 --- a/util/new_textdecoder_encoding_options.md +++ b/util/new_textdecoder_encoding_options.md @@ -2,7 +2,7 @@ added: v8.3.0 changes: - version: v11.0.0 - pr-url: v11.0.0 + pr-url: https://github.com/nodejs/node/pull/22281 description: The class is now available on the global object. --> diff --git a/util/util_format_format_args.md b/util/util_format_format_args.md index 6beff3d3..90971e5d 100644 --- a/util/util_format_format_args.md +++ b/util/util_format_format_args.md @@ -4,10 +4,6 @@ changes: - version: v12.11.0 pr-url: https://github.com/nodejs/node/pull/29606 description: The `%c` specifier is ignored now. - - version: v11.4.0 - pr-url: https://github.com/nodejs/node/pull/23708 - description: The `%d`, `%f` and `%i` specifiers now support Symbols - properly. - version: v12.0.0 pr-url: https://github.com/nodejs/node/pull/23162 description: The `format` argument is now only taken as such if it actually @@ -19,6 +15,10 @@ changes: first argument. This change removes previously present quotes from strings that were being output when the first argument was not a string. + - version: v11.4.0 + pr-url: https://github.com/nodejs/node/pull/23708 + description: The `%d`, `%f` and `%i` specifiers now support Symbols + properly. - version: v11.4.0 pr-url: https://github.com/nodejs/node/pull/24806 description: The `%o` specifier's `depth` has default depth of 4 again. diff --git a/util/util_inspect_object_showhidden_depth_colors.md b/util/util_inspect_object_showhidden_depth_colors.md index b56369bd..9ff2a309 100644 --- a/util/util_inspect_object_showhidden_depth_colors.md +++ b/util/util_inspect_object_showhidden_depth_colors.md @@ -1,7 +1,9 @@ * 返回: {Object} diff --git a/vm/new_vm_script_code_options.md b/vm/new_vm_script_code_options.md index fcb398ef..a1dbbd4f 100644 --- a/vm/new_vm_script_code_options.md +++ b/vm/new_vm_script_code_options.md @@ -1,14 +1,14 @@ * `code` {string} 需要被解析的 JavaScript 代码。 diff --git a/vm/vm_compilefunction_code_params_options.md b/vm/vm_compilefunction_code_params_options.md index cfeecb5d..aadb813d 100644 --- a/vm/vm_compilefunction_code_params_options.md +++ b/vm/vm_compilefunction_code_params_options.md @@ -1,12 +1,15 @@ * `code` {string} 需要编译的函数体。 * `params` {string[]} 包含所有函数参数的字符串数组。 diff --git a/worker_threads/new_worker_filename_options.md b/worker_threads/new_worker_filename_options.md index 7a207f2c..d1571bc0 100644 --- a/worker_threads/new_worker_filename_options.md +++ b/worker_threads/new_worker_filename_options.md @@ -19,16 +19,16 @@ changes: pr-url: https://github.com/nodejs/node/pull/31664 description: The `filename` parameter can be a WHATWG `URL` object using `file:` protocol. - - version: - - v13.2.0 - - v12.16.0 - pr-url: https://github.com/nodejs/node/pull/26628 - description: The `resourceLimits` option was introduced. - version: - v13.4.0 - v12.16.0 pr-url: https://github.com/nodejs/node/pull/30559 description: The `argv` option was introduced. + - version: + - v13.2.0 + - v12.16.0 + pr-url: https://github.com/nodejs/node/pull/26628 + description: The `resourceLimits` option was introduced. --> * `filename` {string} 工作线程主脚本的路径。必须是以 `./` 或 `../` 开头的绝对路径或相对路径（即相对于当前工作目录）、或者使用 `file:` 或 `data:` 协议的 WHATWG `URL` 对象。 diff --git a/zlib/class_options.md b/zlib/class_options.md index a36fa965..d6dae359 100644 --- a/zlib/class_options.md +++ b/zlib/class_options.md @@ -1,7 +1,9 @@