Skip to content

Commit 3fca564

Browse files
AugustinMauroyaduh95
authored andcommitted
doc: add automated migration info to deprecations
PR-URL: #60022 Reviewed-By: Stephen Belanger <[email protected]> Reviewed-By: Jacob Smith <[email protected]> Reviewed-By: Luigi Pinca <[email protected]>
1 parent 20a9e86 commit 3fca564

File tree

1 file changed

+72
-0
lines changed

1 file changed

+72
-0
lines changed

doc/api/deprecations.md

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -551,6 +551,12 @@ Type: End-of-Life
551551
The `os.tmpDir()` API was deprecated in Node.js 7.0.0 and has since been
552552
removed. Please use [`os.tmpdir()`][] instead.
553553

554+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/tmpDir-to-tmpdir)):
555+
556+
```bash
557+
npx codemod@latest @nodejs/tmpDir-to-tmpdir
558+
```
559+
554560
### DEP0023: `os.getNetworkInterfaces()`
555561

556562
<!-- YAML
@@ -628,6 +634,12 @@ Type: End-of-Life
628634

629635
`util.print()` has been removed. Please use [`console.log()`][] instead.
630636

637+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-print-to-console-log)):
638+
639+
```bash
640+
npx codemod@latest @nodejs/util-print-to-console-log
641+
```
642+
631643
### DEP0027: `util.puts()`
632644

633645
<!-- YAML
@@ -649,6 +661,12 @@ Type: End-of-Life
649661

650662
`util.puts()` has been removed. Please use [`console.log()`][] instead.
651663

664+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-print-to-console-log)):
665+
666+
```bash
667+
npx codemod@latest @nodejs/util-print-to-console-log
668+
```
669+
652670
### DEP0028: `util.debug()`
653671

654672
<!-- YAML
@@ -670,6 +688,12 @@ Type: End-of-Life
670688

671689
`util.debug()` has been removed. Please use [`console.error()`][] instead.
672690

691+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-debug-to-console-error)):
692+
693+
```bash
694+
npx codemod@latest @nodejs/util-debug-to-console-error
695+
```
696+
673697
### DEP0029: `util.error()`
674698

675699
<!-- YAML
@@ -691,6 +715,12 @@ Type: End-of-Life
691715

692716
`util.error()` has been removed. Please use [`console.error()`][] instead.
693717

718+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-print-to-console-log)):
719+
720+
```bash
721+
npx codemod@latest @nodejs/util-print-to-console-log
722+
```
723+
694724
### DEP0030: `SlowBuffer`
695725

696726
<!-- YAML
@@ -1359,6 +1389,12 @@ By adopting one of these alternatives, you can transition away from `util.log()`
13591389
and choose a logging strategy that aligns with the specific
13601390
requirements and complexity of your application.
13611391

1392+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/util-log-to-console-log)):
1393+
1394+
```bash
1395+
npx codemod@latest @nodejs/util-log-to-console-log
1396+
```
1397+
13621398
### DEP0060: `util._extend()`
13631399

13641400
<!-- YAML
@@ -2642,6 +2678,12 @@ Type: End-of-Life
26422678

26432679
Use [`module.createRequire()`][] instead.
26442680

2681+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/create-require-from-path)):
2682+
2683+
```bash
2684+
npx codemod@latest @nodejs/create-require-from-path
2685+
```
2686+
26452687
### DEP0131: Legacy HTTP parser
26462688

26472689
<!-- YAML
@@ -2795,6 +2837,12 @@ modules is unsupported.
27952837
It is deprecated in favor of [`require.main`][], because it serves the same
27962838
purpose and is only available on CommonJS environment.
27972839

2840+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/process-main-module)):
2841+
2842+
```bash
2843+
npx codemod@latest @nodejs/process-main-module
2844+
```
2845+
27982846
### DEP0139: `process.umask()` with no arguments
27992847

28002848
<!-- YAML
@@ -2962,6 +3010,12 @@ Use `fs.rm(path, { recursive: true, force: true })`,
29623010
`fs.rmSync(path, { recursive: true, force: true })` or
29633011
`fs.promises.rm(path, { recursive: true, force: true })` instead.
29643012

3013+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/rmdir)):
3014+
3015+
```bash
3016+
npx codemod@latest @nodejs/rmdir
3017+
```
3018+
29653019
### DEP0148: Folder mappings in `"exports"` (trailing `"/"`)
29663020

29673021
<!-- YAML
@@ -3533,6 +3587,12 @@ Type: Documentation-only
35333587
`F_OK`, `R_OK`, `W_OK` and `X_OK` getters exposed directly on `node:fs` are
35343588
deprecated. Get them from `fs.constants` or `fs.promises.constants` instead.
35353589

3590+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/fs-access-mode-constants)):
3591+
3592+
```bash
3593+
npx codemod@latest @nodejs/fs-access-mode-constants
3594+
```
3595+
35363596
### DEP0177: `util.types.isWebAssemblyCompiledModule`
35373597

35383598
<!-- YAML
@@ -3828,6 +3888,12 @@ Instantiating classes without the `new` qualifier exported by the `node:http` mo
38283888
It is recommended to use the `new` qualifier instead. This applies to all http classes, such as
38293889
`OutgoingMessage`, `IncomingMessage`, `ServerResponse` and `ClientRequest`.
38303890

3891+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/http-classes-with-new)):
3892+
3893+
```bash
3894+
npx codemod@latest @nodejs/http-classes-with-new
3895+
```
3896+
38313897
### DEP0196: Calling `node:child_process` functions with `options.shell` as an empty string
38323898

38333899
<!-- YAML
@@ -3853,6 +3919,12 @@ a shell, use [`child_process.execFile`][] instead.
38533919

38543920
<!-- md-lint skip-deprecation DEP0197 -->
38553921

3922+
An automated migration is available ([source](https://github.com/nodejs/userland-migrations/tree/main/recipes/types-is-native-error)):
3923+
3924+
```bash
3925+
npx codemod@latest @nodejs/types-is-native-error
3926+
```
3927+
38563928
### DEP0198: Creating SHAKE-128 and SHAKE-256 digests without an explicit `options.outputLength`
38573929

38583930
<!-- YAML

0 commit comments

Comments
 (0)