Lines Matching +full:node +full:- +full:api

3 <!--introduced_in=v7.7.0-->
4 <!-- type=misc -->
6 Node.js may deprecate APIs for any of the following reasons:
8 * Use of the API is unsafe.
9 * An improved alternative API is available.
10 * Breaking changes to the API are expected in a future major release.
12 Node.js utilizes three kinds of Deprecations:
14 * Documentation-only
16 * End-of-Life
18 A Documentation-only deprecation is one that is expressed only within the
19 Node.js API docs. These generate no side-effects while running Node.js.
20 Some Documentation-only deprecations trigger a runtime warning when launched
21 with [`--pending-deprecation`][] flag (or its alternative,
23 deprecations below. Documentation-only deprecations that support that flag
28 be printed to `stderr` the first time the deprecated API is used. When the
29 [`--throw-deprecation`][] command-line flag is used, a Runtime deprecation will
32 An End-of-Life deprecation is used when functionality is or will soon be removed
33 from Node.js.
37 Occasionally, the deprecation of an API may be reversed. In such situations,
45 <!-- YAML
47   - version:
48     - v4.8.6
49     - v6.12.0
50     pr-url: https://github.com/nodejs/node/pull/10116
52   - version: v1.6.0
53     pr-url: https://github.com/nodejs/node/pull/1156
55 -->
64 <!-- YAML
66   - version: v8.0.0
67     pr-url: https://github.com/nodejs/node/pull/12113
68     description: End-of-Life.
69   - version: v6.12.0
70     pr-url: https://github.com/nodejs/node/pull/10116
72   - version: v5.0.0
73     pr-url: https://github.com/nodejs/node/pull/3078
75 -->
77 Type: End-of-Life
83 <!-- YAML
85   - version:
86     - v4.8.6
87     - v6.12.0
88     pr-url: https://github.com/nodejs/node/pull/10116
90   - version: v0.11.15
91     pr-url: https://github.com/nodejs/node-v0.x-archive/pull/8826
93 -->
102 <!-- YAML
104   - version: v10.0.0
105     pr-url: https://github.com/nodejs/node/pull/17882
106     description: End-of-Life.
107   - version:
108     - v4.8.6
109     - v6.12.0
110     pr-url: https://github.com/nodejs/node/pull/10116
112   - version: 0.4.0
114     description: Documentation-only deprecation.
115 -->
117 Type: End-of-Life
123 <!-- YAML
125   - version: v10.0.0
126     pr-url: https://github.com/nodejs/node/pull/19524
128   - version: v6.12.0
129     pr-url: https://github.com/nodejs/node/pull/10116
131   - version: v6.0.0
132     pr-url: https://github.com/nodejs/node/pull/4682
133     description: Documentation-only deprecation.
134 -->
136 Type: Runtime (supports [`--pending-deprecation`][])
139 API usability issues that can lead to accidental security issues.
151 * [`Buffer.from(arrayBuffer[, byteOffset[, length]])`][from_arraybuffer] -
157 Without `--pending-deprecation`, runtime warnings occur only for code not in
159 `Buffer()` usage in dependencies. With `--pending-deprecation`, a runtime
164 <!-- YAML
166   - version: v12.0.0
167     pr-url: https://github.com/nodejs/node/pull/25279
168     description: End-of-Life.
169   - version:
170     - v4.8.6
171     - v6.12.0
172     pr-url: https://github.com/nodejs/node/pull/10116
174   - version: v0.11.14
176   - version: v0.5.11
177     description: Documentation-only deprecation.
178 -->
180 Type: End-of-Life
188 <!-- YAML
190   - version: v9.0.0
191     pr-url: https://github.com/nodejs/node/pull/13702
192     description: End-of-Life.
193   - version: v7.0.0
194     pr-url: https://github.com/nodejs/node/pull/3747
196   - version: v6.12.0
197     pr-url: https://github.com/nodejs/node/pull/10116
199   - version: v6.0.0
200     pr-url: https://github.com/nodejs/node/pull/3743
201     description: Documentation-only deprecation.
202 -->
204 Type: End-of-Life
206 In an earlier version of the Node.js `cluster`, a boolean property with the name
208 provide an indication of how and why the `Worker` instance exited. In Node.js
211 precisely describe the actual semantics and was unnecessarily emotion-laden.
215 <!-- YAML
217   - version: v6.12.0
218     pr-url: https://github.com/nodejs/node/pull/10116
220   - version: v6.3.0
221     pr-url: https://github.com/nodejs/node/pull/6534
222     description: Documentation-only deprecation.
223 -->
225 Type: Documentation-only
228 relevant to specific Node.js builtin modules, developers should instead refer
234 <!-- YAML
236   - version: v11.0.0
237     pr-url: https://github.com/nodejs/node/pull/22861
239   - version: v8.0.0
240     pr-url: https://github.com/nodejs/node/pull/11305
241     description: End-of-Life (for `digest === undefined`).
242   - version: v6.12.0
243     pr-url: https://github.com/nodejs/node/pull/10116
245   - version: v6.0.0
246     pr-url: https://github.com/nodejs/node/pull/4047
248 -->
252 Use of the [`crypto.pbkdf2()`][] API without specifying a digest was deprecated
253 in Node.js 6.0 because the method defaulted to using the non-recommended
255 Node.js 8.0.0, calling `crypto.pbkdf2()` or `crypto.pbkdf2Sync()` with
258 Beginning in Node.js v11.0.0, calling these functions with `digest` set to
264 <!-- YAML
266   - version: v11.0.0
267     pr-url: https://github.com/nodejs/node/pull/21153
268     description: End-of-Life.
269   - version:
270     - v4.8.6
271     - v6.12.0
272     pr-url: https://github.com/nodejs/node/pull/10116
274   - version: v0.11.13
275     pr-url: https://github.com/nodejs/node-v0.x-archive/pull/7265
277 -->
279 Type: End-of-Life
281 The `crypto.createCredentials()` API was removed. Please use
286 <!-- YAML
288   - version: v11.0.0
289     pr-url: https://github.com/nodejs/node/pull/21153
290     description: End-of-Life.
291   - version:
292     - v4.8.6
293     - v6.12.0
294     pr-url: https://github.com/nodejs/node/pull/10116
296   - version: v0.11.13
297     pr-url: https://github.com/nodejs/node-v0.x-archive/pull/7265
299 -->
301 Type: End-of-Life
308 <!-- YAML
310   - version: v9.0.0
311     pr-url: https://github.com/nodejs/node/pull/15412
312     description: End-of-Life.
313   - version:
314     - v4.8.6
315     - v6.12.0
316     pr-url: https://github.com/nodejs/node/pull/10116
318   - version: v0.11.7
319     pr-url: https://github.com/nodejs/node-v0.x-archive/pull/5021
321 -->
323 Type: End-of-Life
330 <!-- YAML
332   - version: v10.0.0
333     pr-url: https://github.com/nodejs/node/pull/18668
334     description: End-of-Life.
335   - version: v7.0.0
336     pr-url: https://github.com/nodejs/node/pull/7897
338 -->
340 Type: End-of-Life
343 in Node.js 10.0.0 onwards. See <https://github.com/nodejs/node/pull/12562>.
347 <!-- YAML
349   - version: v8.0.0
350     pr-url: https://github.com/nodejs/node/pull/9683
351     description: End-of-Life.
352   - version: v6.0.0
353     pr-url: https://github.com/nodejs/node/pull/4525
355   - version:
356     - v4.8.6
357     - v6.12.0
358     pr-url: https://github.com/nodejs/node/pull/10116
360   - version: v0.1.96
362     description: Documentation-only deprecation.
363 -->
365 Type: End-of-Life
368 API as mentioned in the documentation instead.
372 <!-- YAML
374   - version: v8.0.0
375     pr-url: https://github.com/nodejs/node/pull/9683
376     description: End-of-Life.
377   - version: v6.0.0
378     pr-url: https://github.com/nodejs/node/pull/4525
380   - version:
381     - v4.8.6
382     - v6.12.0
383     pr-url: https://github.com/nodejs/node/pull/10116
385   - version: v0.1.96
387     description: Documentation-only deprecation.
388 -->
390 Type: End-of-Life
393 `Buffer` API as mentioned in the documentation instead.
397 <!-- YAML
399   - version: v6.12.0
400     pr-url: https://github.com/nodejs/node/pull/10116
402   - version: v6.0.0
403     pr-url: https://github.com/nodejs/node/pull/1838
405 -->
414 <!-- YAML
416   - version: v9.0.0
417     pr-url: https://github.com/nodejs/node/pull/15238
418     description: End-of-Life.
419   - version: v7.0.0
420     pr-url: https://github.com/nodejs/node/pull/8908
422 -->
424 Type: End-of-Life
426 `Intl.v8BreakIterator` was a non-standard extension and has been removed.
427 See [`Intl.Segmenter`](https://github.com/tc39/proposal-intl-segmenter).
431 <!-- YAML
433   - version: v7.0.0
434     pr-url: https://github.com/nodejs/node/pull/8217
436 -->
441 that are not handled will terminate the Node.js process with a non-zero exit
446 <!-- YAML
448   - version: v12.0.0
449     pr-url: https://github.com/nodejs/node/pull/26973
451   - version:
452     - v4.8.6
453     - v6.12.0
454     pr-url: https://github.com/nodejs/node/pull/10116
456   - version: v1.8.1
457     pr-url: https://github.com/nodejs/node/pull/1363
459 -->
461 Type: End-of-Life
468 <!-- YAML
470   - version:
471     - v4.8.6
472     - v6.12.0
473     pr-url: https://github.com/nodejs/node/pull/10116
475   - version: v0.9.7
476     pr-url: https://github.com/nodejs/node-v0.x-archive/pull/4595
478 -->
487 <!-- YAML
489   - version: v12.0.0
490     pr-url: https://github.com/nodejs/node/pull/27127
491     description: End-of-Life.
492   - version:
493     - v4.8.6
494     - v6.12.0
495     pr-url: https://github.com/nodejs/node/pull/10116
497   - version: v0.7.12
500 -->
502 Type: End-of-Life
509 <!-- YAML
511   - version: v7.0.0
512     pr-url: https://github.com/nodejs/node/pull/6739
514 -->
518 The `os.tmpDir()` API is deprecated. Please use [`os.tmpdir()`][] instead.
522 <!-- YAML
524   - version: v12.0.0
525     pr-url: https://github.com/nodejs/node/pull/25280
526     description: End-of-Life.
527   - version:
528     - v4.8.6
529     - v6.12.0
530     pr-url: https://github.com/nodejs/node/pull/10116
532   - version: v0.6.0
535 -->
537 Type: End-of-Life
544 <!-- YAML
546   - version: v9.0.0
547     pr-url: https://github.com/nodejs/node/pull/13434
548     description: End-of-Life.
549   - version: v7.0.0
550     pr-url: https://github.com/nodejs/node/pull/7829
552 -->
554 Type: End-of-Life
556 The `REPLServer.prototype.convertToContext()` API has been removed.
560 <!-- YAML
562   - version:
563     - v4.8.6
564     - v6.12.0
565     pr-url: https://github.com/nodejs/node/pull/10116
567   - version: v1.0.0
568     pr-url: https://github.com/nodejs/node/pull/317
570 -->
578 <!-- YAML
580   - version: v12.0.0
581     pr-url: https://github.com/nodejs/node/pull/25377
582     description: End-of-Life.
583   - version:
584     - v4.8.6
585     - v6.12.0
586     pr-url: https://github.com/nodejs/node/pull/10116
588   - version: v0.11.3
591 -->
593 Type: End-of-Life
599 <!-- YAML
601   - version: v12.0.0
602     pr-url: https://github.com/nodejs/node/pull/25377
603     description: End-of-Life.
604   - version:
605     - v4.8.6
606     - v6.12.0
607     pr-url: https://github.com/nodejs/node/pull/10116
609   - version: v0.11.3
612 -->
614 Type: End-of-Life
620 <!-- YAML
622   - version: v12.0.0
623     pr-url: https://github.com/nodejs/node/pull/25377
624     description: End-of-Life.
625   - version:
626     - v4.8.6
627     - v6.12.0
628     pr-url: https://github.com/nodejs/node/pull/10116
630   - version: v0.11.3
633 -->
635 Type: End-of-Life
641 <!-- YAML
643   - version: v12.0.0
644     pr-url: https://github.com/nodejs/node/pull/25377
645     description: End-of-Life.
646   - version:
647     - v4.8.6
648     - v6.12.0
649     pr-url: https://github.com/nodejs/node/pull/10116
651   - version: v0.11.3
654 -->
656 Type: End-of-Life
662 <!-- YAML
664   - version: v6.12.0
665     pr-url: https://github.com/nodejs/node/pull/10116
667   - version: v6.0.0
668     pr-url: https://github.com/nodejs/node/pull/5833
669     description: Documentation-only deprecation.
670 -->
672 Type: Documentation-only
679 <!-- YAML
681   - version: v6.12.0
682     pr-url: https://github.com/nodejs/node/pull/10116
684   - version: v5.2.0
685     pr-url: https://github.com/nodejs/node/pull/3511
686     description: Documentation-only deprecation.
687 -->
689 Type: Documentation-only
692 API is not useful.
696 <!-- YAML
698   - version:
699     - v4.8.6
700     - v6.12.0
701     pr-url: https://github.com/nodejs/node/pull/10116
703   - version: v1.4.2
704     pr-url: https://github.com/nodejs/node/pull/943
705     description: Documentation-only deprecation.
706 -->
708 Type: Documentation-only
714 <!-- YAML
716   - version:
717     - v4.8.6
718     - v6.12.0
719     pr-url: https://github.com/nodejs/node/pull/10116
721   - version: v3.2.0
722     pr-url: https://github.com/nodejs/node/pull/2349
723     description: Documentation-only deprecation.
724 -->
726 Type: Documentation-only
728 The [`EventEmitter.listenerCount(emitter, eventName)`][] API is
733 <!-- YAML
735   - version:
736     - v4.8.6
737     - v6.12.0
738     pr-url: https://github.com/nodejs/node/pull/10116
740   - version: v1.0.0
741     pr-url: https://github.com/iojs/io.js/pull/166
742     description: Documentation-only deprecation.
743 -->
745 Type: Documentation-only
747 The [`fs.exists(path, callback)`][] API is deprecated. Please use
752 <!-- YAML
754   - version:
755     - v4.8.6
756     - v6.12.0
757     pr-url: https://github.com/nodejs/node/pull/10116
759   - version: v0.4.7
760     description: Documentation-only deprecation.
761 -->
763 Type: Documentation-only
765 The [`fs.lchmod(path, mode, callback)`][] API is deprecated.
769 <!-- YAML
771   - version:
772     - v4.8.6
773     - v6.12.0
774     pr-url: https://github.com/nodejs/node/pull/10116
776   - version: v0.4.7
777     description: Documentation-only deprecation.
778 -->
780 Type: Documentation-only
782 The [`fs.lchmodSync(path, mode)`][] API is deprecated.
786 <!-- YAML
788   - version: v10.6.0
789     pr-url: https://github.com/nodejs/node/pull/21498
791   - version:
792     - v4.8.6
793     - v6.12.0
794     pr-url: https://github.com/nodejs/node/pull/10116
796   - version: v0.4.7
797     description: Documentation-only deprecation.
798 -->
802 The [`fs.lchown(path, uid, gid, callback)`][] API was deprecated. The
808 <!-- YAML
810   - version: v10.6.0
811     pr-url: https://github.com/nodejs/node/pull/21498
813   - version:
814     - v4.8.6
815     - v6.12.0
816     pr-url: https://github.com/nodejs/node/pull/10116
818   - version: v0.4.7
819     description: Documentation-only deprecation.
820 -->
824 The [`fs.lchownSync(path, uid, gid)`][] API was deprecated. The deprecation was
829 <!-- YAML
831   - version:
832     - v4.8.6
833     - v6.12.0
834     pr-url: https://github.com/nodejs/node/pull/10116
836   - version: v0.10.6
838     description: Documentation-only deprecation.
839 -->
841 Type: Documentation-only
847 <!-- YAML
849   - version: v7.0.0
850     pr-url: https://github.com/nodejs/node/pull/7941
851     description: Documentation-only deprecation.
852 -->
854 Type: Documentation-only
861 <!-- YAML
863   - version: v10.0.0
864     pr-url: https://github.com/nodejs/node/pull/13876
865     description: End-of-Life.
866   - version:
867     - v4.8.6
868     - v6.12.0
869     pr-url: https://github.com/nodejs/node/pull/10116
871   - version: v3.0.0
872     pr-url: https://github.com/nodejs/node/pull/2224
873     description: Documentation-only deprecation.
874 -->
876 Type: End-of-Life
883 <!-- YAML
885   - version: v10.0.0
886     pr-url: https://github.com/nodejs/node/pull/17882
887     description: End-of-Life.
888   - version:
889     - v4.8.6
890     - v6.12.0
891     pr-url: https://github.com/nodejs/node/pull/10116
893   - version: v0.11.3
895     description: Documentation-only deprecation.
896 -->
898 Type: End-of-Life
905 <!-- YAML
907   - version: v8.0.0
908     pr-url: https://github.com/nodejs/node/pull/11349
910   - version: v6.12.0
911     pr-url: https://github.com/nodejs/node/pull/10116
913   - version: v6.0.0
914     pr-url: https://github.com/nodejs/node/pull/6063
915     description: Documentation-only deprecation.
916   - version: v0.11.15
917     pr-url:
918       - https://github.com/nodejs/node-v0.x-archive/pull/8695
919       - https://github.com/nodejs/node-v0.x-archive/pull/8700
921   - version: v0.11.3
924 -->
926 Type: Documentation-only
933 <!-- YAML
935   - version:
936     - v4.8.6
937     - v6.12.0
938     pr-url: https://github.com/nodejs/node/pull/10116
940   - version:
941     - v3.3.1
942     - v4.0.0
943     pr-url: https://github.com/nodejs/node/pull/2447
944     description: Documentation-only deprecation.
945 -->
947 Type: Documentation-only
949 The [`util.isArray()`][] API is deprecated. Please use `Array.isArray()`
954 <!-- YAML
956   - version:
957     - v4.8.6
958     - v6.12.0
959     pr-url: https://github.com/nodejs/node/pull/10116
961   - version:
962     - v3.3.1
963     - v4.0.0
964     pr-url: https://github.com/nodejs/node/pull/2447
965     description: Documentation-only deprecation.
966 -->
968 Type: Documentation-only
970 The [`util.isBoolean()`][] API is deprecated.
974 <!-- YAML
976   - version:
977     - v4.8.6
978     - v6.12.0
979     pr-url: https://github.com/nodejs/node/pull/10116
981   - version:
982     - v3.3.1
983     - v4.0.0
984     pr-url: https://github.com/nodejs/node/pull/2447
985     description: Documentation-only deprecation.
986 -->
988 Type: Documentation-only
990 The [`util.isBuffer()`][] API is deprecated. Please use
995 <!-- YAML
997   - version:
998     - v4.8.6
999     - v6.12.0
1000     pr-url: https://github.com/nodejs/node/pull/10116
1002   - version:
1003     - v3.3.1
1004     - v4.0.0
1005     pr-url: https://github.com/nodejs/node/pull/2447
1006     description: Documentation-only deprecation.
1007 -->
1009 Type: Documentation-only
1011 The [`util.isDate()`][] API is deprecated.
1015 <!-- YAML
1017   - version:
1018     - v4.8.6
1019     - v6.12.0
1020     pr-url: https://github.com/nodejs/node/pull/10116
1022   - version:
1023     - v3.3.1
1024     - v4.0.0
1025     pr-url: https://github.com/nodejs/node/pull/2447
1026     description: Documentation-only deprecation.
1027 -->
1029 Type: Documentation-only
1031 The [`util.isError()`][] API is deprecated.
1035 <!-- YAML
1037   - version:
1038     - v4.8.6
1039     - v6.12.0
1040     pr-url: https://github.com/nodejs/node/pull/10116
1042   - version:
1043     - v3.3.1
1044     - v4.0.0
1045     pr-url: https://github.com/nodejs/node/pull/2447
1046     description: Documentation-only deprecation.
1047 -->
1049 Type: Documentation-only
1051 The [`util.isFunction()`][] API is deprecated.
1055 <!-- YAML
1057   - version:
1058     - v4.8.6
1059     - v6.12.0
1060     pr-url: https://github.com/nodejs/node/pull/10116
1062   - version:
1063     - v3.3.1
1064     - v4.0.0
1065     pr-url: https://github.com/nodejs/node/pull/2447
1066     description: Documentation-only deprecation.
1067 -->
1069 Type: Documentation-only
1071 The [`util.isNull()`][] API is deprecated.
1075 <!-- YAML
1077   - version:
1078     - v4.8.6
1079     - v6.12.0
1080     pr-url: https://github.com/nodejs/node/pull/10116
1082   - version:
1083     - v3.3.1
1084     - v4.0.0
1085     pr-url: https://github.com/nodejs/node/pull/2447
1086     description: Documentation-only deprecation.
1087 -->
1089 Type: Documentation-only
1091 The [`util.isNullOrUndefined()`][] API is deprecated.
1095 <!-- YAML
1097   - version:
1098     - v4.8.6
1099     - v6.12.0
1100     pr-url: https://github.com/nodejs/node/pull/10116
1102   - version:
1103     - v3.3.1
1104     - v4.0.0
1105     pr-url: https://github.com/nodejs/node/pull/2447
1106     description: Documentation-only deprecation.
1107 -->
1109 Type: Documentation-only
1111 The [`util.isNumber()`][] API is deprecated.
1115 <!-- YAML
1117   - version:
1118     - v4.8.6
1119     - v6.12.0
1120     pr-url: https://github.com/nodejs/node/pull/10116
1122   - version:
1123     - v3.3.1
1124     - v4.0.0
1125     pr-url: https://github.com/nodejs/node/pull/2447
1126     description: Documentation-only deprecation.
1127 -->
1129 Type: Documentation-only
1131 The [`util.isObject()`][] API is deprecated.
1135 <!-- YAML
1137   - version:
1138     - v4.8.6
1139     - v6.12.0
1140     pr-url: https://github.com/nodejs/node/pull/10116
1142   - version:
1143     - v3.3.1
1144     - v4.0.0
1145     pr-url: https://github.com/nodejs/node/pull/2447
1146     description: Documentation-only deprecation.
1147 -->
1149 Type: Documentation-only
1151 The [`util.isPrimitive()`][] API is deprecated.
1155 <!-- YAML
1157   - version:
1158     - v4.8.6
1159     - v6.12.0
1160     pr-url: https://github.com/nodejs/node/pull/10116
1162   - version:
1163     - v3.3.1
1164     - v4.0.0
1165     pr-url: https://github.com/nodejs/node/pull/2447
1166     description: Documentation-only deprecation.
1167 -->
1169 Type: Documentation-only
1171 The [`util.isRegExp()`][] API is deprecated.
1175 <!-- YAML
1177   - version:
1178     - v4.8.6
1179     - v6.12.0
1180     pr-url: https://github.com/nodejs/node/pull/10116
1182   - version:
1183     - v3.3.1
1184     - v4.0.0
1185     pr-url: https://github.com/nodejs/node/pull/2447
1186     description: Documentation-only deprecation.
1187 -->
1189 Type: Documentation-only
1191 The [`util.isString()`][] API is deprecated.
1195 <!-- YAML
1197   - version:
1198     - v4.8.6
1199     - v6.12.0
1200     pr-url: https://github.com/nodejs/node/pull/10116
1202   - version:
1203     - v3.3.1
1204     - v4.0.0
1205     pr-url: https://github.com/nodejs/node/pull/2447
1206     description: Documentation-only deprecation.
1207 -->
1209 Type: Documentation-only
1211 The [`util.isSymbol()`][] API is deprecated.
1215 <!-- YAML
1217   - version:
1218     - v4.8.6
1219     - v6.12.0
1220     pr-url: https://github.com/nodejs/node/pull/10116
1222   - version:
1223     - v3.3.1
1224     - v4.0.0
1225     pr-url: https://github.com/nodejs/node/pull/2447
1226     description: Documentation-only deprecation.
1227 -->
1229 Type: Documentation-only
1231 The [`util.isUndefined()`][] API is deprecated.
1235 <!-- YAML
1237   - version: v6.12.0
1238     pr-url: https://github.com/nodejs/node/pull/10116
1240   - version: v6.0.0
1241     pr-url: https://github.com/nodejs/node/pull/6161
1242     description: Documentation-only deprecation.
1243 -->
1245 Type: Documentation-only
1247 The [`util.log()`][] API is deprecated.
1251 <!-- YAML
1253   - version: v6.12.0
1254     pr-url: https://github.com/nodejs/node/pull/10116
1256   - version: v6.0.0
1257     pr-url: https://github.com/nodejs/node/pull/4903
1258     description: Documentation-only deprecation.
1259 -->
1261 Type: Documentation-only
1263 The [`util._extend()`][] API is deprecated.
1267 <!-- YAML
1269   - version: v11.0.0
1270     pr-url: https://github.com/nodejs/node/pull/20735
1271     description: End-of-Life.
1272   - version: v8.0.0
1273     pr-url: https://github.com/nodejs/node/pull/10467
1275   - version: v7.0.0
1276     pr-url: https://github.com/nodejs/node/pull/6749
1277     description: Documentation-only deprecation.
1278 -->
1280 Type: End-of-Life
1283 API and has been removed. No alternative API is available. Please use a userland
1287 ### DEP0062: `node --debug`
1288 <!-- YAML
1290   - version: v8.0.0
1291     pr-url: https://github.com/nodejs/node/pull/10970
1293   - version: v12.0.0
1294     pr-url: https://github.com/nodejs/node/pull/25828
1295     description: End-of-Life.
1296 -->
1298 Type: End-of-Life
1300 `--debug` activates the legacy V8 debugger interface, which was removed as
1301 of V8 5.8. It is replaced by Inspector which is activated with `--inspect`
1306 <!-- YAML
1308   - version: v8.0.0
1309     pr-url: https://github.com/nodejs/node/pull/11355
1310     description: Documentation-only deprecation.
1311 -->
1313 Type: Documentation-only
1315 The `http` module `ServerResponse.prototype.writeHeader()` API is
1319 officially supported API.
1323 <!-- YAML
1325   - version: v8.0.0
1326     pr-url: https://github.com/nodejs/node/pull/11349
1328   - version: v6.12.0
1329     pr-url: https://github.com/nodejs/node/pull/10116
1331   - version: v6.0.0
1332     pr-url: https://github.com/nodejs/node/pull/6063
1333     description: Documentation-only deprecation.
1334   - version: v0.11.15
1335     pr-url:
1336       - https://github.com/nodejs/node-v0.x-archive/pull/8695
1337       - https://github.com/nodejs/node-v0.x-archive/pull/8700
1339   - version: v0.11.3
1342 -->
1346 The `tls.createSecurePair()` API was deprecated in documentation in Node.js
1351 <!-- YAML
1353   - version: v10.0.0
1354     pr-url: https://github.com/nodejs/node/pull/19187
1355     description: End-of-Life.
1356   - version: v8.0.0
1357     pr-url: https://github.com/nodejs/node/pull/11599
1358     description: Documentation-only deprecation.
1359 -->
1361 Type: End-of-Life
1365 `REPL_MODE_SLOPPY` since Node.js 6.0.0, when V8 5.0 was imported. Please use
1369 `replMode` of an interactive `node` session. Its value, `magic`, is also
1374 <!-- YAML
1376   - version: v12.0.0
1377     pr-url: https://github.com/nodejs/node/pull/24167
1379   - version: v8.0.0
1380     pr-url: https://github.com/nodejs/node/pull/10941
1381     description: Documentation-only deprecation.
1382 -->
1401 <!-- YAML
1403   - version: v8.0.0
1404     pr-url: https://github.com/nodejs/node/pull/10941
1405     description: Documentation-only deprecation.
1406 -->
1408 Type: Documentation-only
1410 The `http` module `OutgoingMessage.prototype._renderHeaders()` API is
1414 an officially supported API.
1417 ### DEP0068: `node debug`
1418 <!-- YAML
1420   - version: v8.0.0
1421     pr-url: https://github.com/nodejs/node/pull/11441
1423 -->
1427 `node debug` corresponds to the legacy CLI debugger which has been replaced with
1428 a V8-inspector based CLI debugger available through `node inspect`.
1432 <!-- YAML
1434   - version: v10.0.0
1435     pr-url: https://github.com/nodejs/node/pull/13295
1436     description: End-of-Life.
1437   - version: v9.0.0
1438     pr-url: https://github.com/nodejs/node/pull/12815
1440   - version: v8.0.0
1441     pr-url: https://github.com/nodejs/node/pull/12243
1442     description: Documentation-only deprecation.
1443 -->
1445 Type: End-of-Life
1447 DebugContext has been removed in V8 and is not available in Node.js 10+.
1449 DebugContext was an experimental API.
1453 <!-- YAML
1455   - version: v9.0.0
1456     pr-url: https://github.com/nodejs/node/pull/14414
1457     description: End-of-Life.
1458   - version: v8.2.0
1459     pr-url: https://github.com/nodejs/node/pull/13490
1461 -->
1463 Type: End-of-Life
1468 This change was made while `async_hooks` was an experimental API.
1472 <!-- YAML
1474   - version: v9.0.0
1475     pr-url: https://github.com/nodejs/node/pull/14414
1476     description: End-of-Life.
1477   - version: v8.2.0
1478     pr-url: https://github.com/nodejs/node/pull/13490
1480 -->
1482 Type: End-of-Life
1487 This change was made while `async_hooks` was an experimental API.
1491 <!-- YAML
1493   - version: v9.0.0
1494     pr-url: https://github.com/nodejs/node/pull/14414
1495     description: End-of-Life.
1496   - version: v8.2.0
1497     pr-url: https://github.com/nodejs/node/pull/13490
1499 -->
1501 Type: End-of-Life
1506 This change was made while `async_hooks` was an experimental API.
1510 <!-- YAML
1512   - version: v10.0.0
1513     pr-url: https://github.com/nodejs/node/pull/17141
1514     description: End-of-Life.
1515   - version: v9.0.0
1516     pr-url: https://github.com/nodejs/node/pull/14449
1518 -->
1520 Type: End-of-Life
1525 As the original API was undocumented and not generally useful for non-internal
1526 code, no replacement API is provided.
1530 <!-- YAML
1532   - version: v9.0.0
1533     pr-url: https://github.com/nodejs/node/pull/13687
1535 -->
1544 <!-- YAML
1546   - version: v9.0.0
1547     pr-url: https://github.com/nodejs/node/pull/14223
1549 -->
1557 <!-- YAML
1559   - version: v9.0.0
1560     pr-url: https://github.com/nodejs/node/pull/14249
1562   - version: v8.6.0
1563     pr-url: https://github.com/nodejs/node/pull/14245
1564     description: Documentation-only deprecation.
1565 -->
1589 <!-- YAML
1591   - version: v9.0.0
1592     pr-url: https://github.com/nodejs/node/pull/13948
1594 -->
1601 supported API.
1605 <!-- YAML
1607   - version: v9.0.0
1608     pr-url: https://github.com/nodejs/node/pull/15136
1610 -->
1618 <!-- YAML
1620   - version: v11.0.0
1621     pr-url: https://github.com/nodejs/node/pull/20722
1622     description: End-of-Life.
1623   - version: v10.0.0
1624     pr-url: https://github.com/nodejs/node/pull/16393
1626   - version: v8.7.0
1627     pr-url: https://github.com/nodejs/node/pull/15631
1628     description: Documentation-only deprecation.
1629 -->
1631 Type: End-of-Life
1635 instead. For backward compatibility with Node.js prior to version 6.4.0, both
1640 <!-- YAML
1642   - version: v9.0.0
1643     pr-url: https://github.com/nodejs/node/pull/14956
1644     description: Documentation-only deprecation.
1645 -->
1647 Type: Documentation-only
1650 userland modules have found it useful. The internal API is deprecated
1655 <!-- YAML
1657   - version: v9.0.0
1658     pr-url: https://github.com/nodejs/node/pull/15990
1660 -->
1670 <!-- YAML
1672   - version: v9.0.0
1673     pr-url: https://github.com/nodejs/node/pull/16242
1675 -->
1684 <!-- YAML
1686   - version: v10.0.0
1687     pr-url: https://github.com/nodejs/node/pull/19794
1688     description: End-of-Life.
1689   - version: v9.2.0
1690     pr-url: https://github.com/nodejs/node/pull/16130
1692 -->
1694 Type: End-of-Life.
1703 <!-- YAML
1705   - version: v12.0.0
1706     pr-url: https://github.com/nodejs/node/pull/25138
1708   - version: v10.0.0
1709     pr-url: https://github.com/nodejs/node/pull/16392
1711 -->
1713 Type: End-of-Life
1715 Since Node.js versions 4.4.0 and 5.2.0, several modules only intended for
1727 * `v8/tools/tickprocessor-driver`
1729 * `node-inspect/lib/_inspect` (from 7.6.0)
1730 * `node-inspect/lib/internal/inspect_client` (from 7.6.0)
1731 * `node-inspect/lib/internal/inspect_repl` (from 7.6.0)
1737 On the other hand, `node-inspect` may be installed locally through a package
1742 ### DEP0085: AsyncHooks sensitive API
1743 <!-- YAML
1745   - version: 10.0.0
1746     pr-url: https://github.com/nodejs/node/pull/17147
1747     description: End-of-Life.
1748   - version:
1749     - v8.10.0
1750     - v9.4.0
1751     pr-url: https://github.com/nodejs/node/pull/16972
1753 -->
1755 Type: End-of-Life
1757 The AsyncHooks sensitive API was never documented and had various minor issues.
1758 Use the `AsyncResource` API instead. See
1759 <https://github.com/nodejs/node/issues/15572>.
1763 <!-- YAML
1765   - version: 10.0.0
1766     pr-url: https://github.com/nodejs/node/pull/17147
1767     description: End-of-Life.
1768   - version:
1769     - v8.10.0
1770     - v9.4.0
1771     pr-url: https://github.com/nodejs/node/pull/16972
1773 -->
1775 Type: End-of-Life
1778 cause a lot of issues. See <https://github.com/nodejs/node/issues/14328>.
1782 <!-- YAML
1784   - version: v12.8.0
1785     pr-url: https://github.com/nodejs/node/pull/28892
1787   - version:
1788       - v9.9.0
1789       - v10.0.0
1790     pr-url: https://github.com/nodejs/node/pull/17002
1791     description: Documentation-only deprecation.
1792 -->
1802 <!-- YAML
1804   - version: v11.0.0
1805     pr-url: https://github.com/nodejs/node/pull/17825
1806     description: End-of-Life.
1807   - version: v10.0.0
1808     pr-url: https://github.com/nodejs/node/pull/18017
1810 -->
1812 Type: End-of-Life
1814 Node.js used to support all GCM authentication tag lengths which are accepted by
1815 OpenSSL when calling [`decipher.setAuthTag()`][]. Beginning with Node.js
1818 [NIST SP 800-38D][].
1822 <!-- YAML
1824   - version: v10.0.0
1825     pr-url: https://github.com/nodejs/node/pull/18333
1827 -->
1834 ### DEP0092: Top-level `this` bound to `module.exports`
1835 <!-- YAML
1837   - version: v10.0.0
1838     pr-url: https://github.com/nodejs/node/pull/16878
1839     description: Documentation-only deprecation.
1840 -->
1842 Type: Documentation-only
1844 Assigning properties to the top-level `this` as an alternative
1850 <!-- YAML
1852   - version: v10.0.0
1853     pr-url: https://github.com/nodejs/node/pull/18335
1854     description: Documentation-only deprecation.
1855 -->
1857 Type: Documentation-only
1864 <!-- YAML
1866   - version: v10.0.0
1867     pr-url: https://github.com/nodejs/node/pull/18418
1869 -->
1879 <!-- YAML
1881   - version: v10.0.0
1882     pr-url: https://github.com/nodejs/node/pull/18066
1884 -->
1893 <!-- YAML
1895   - version: v10.0.0
1896     pr-url: https://github.com/nodejs/node/pull/18066
1898 -->
1907 <!-- YAML
1909   - version: v10.0.0
1910     pr-url: https://github.com/nodejs/node/pull/17417
1912 -->
1918 `CallbackScope`, or the high-level `AsyncResource` class.
1922 <!-- YAML
1924   - version: v12.0.0
1925     pr-url: https://github.com/nodejs/node/pull/26530
1926     description: End-of-Life
1927   - version:
1928     - v8.12.0
1929     - v9.6.0
1930     - v10.0.0
1931     pr-url: https://github.com/nodejs/node/pull/18632
1933 -->
1935 Type: End-of-Life
1937 The embedded API provided by AsyncHooks exposes `.emitBefore()` and
1941 Use [`asyncResource.runInAsyncScope()`][] API instead which provides a much
1943 <https://github.com/nodejs/node/pull/18513>.
1946 ### DEP0099: Async context-unaware `node::MakeCallback` C++ APIs
1947 <!-- YAML
1949   - version: v10.0.0
1950     pr-url: https://github.com/nodejs/node/pull/18632
1951     description: Compile-time deprecation.
1952 -->
1954 Type: Compile-time
1956 Certain versions of `node::MakeCallback` APIs available to native modules are
1957 deprecated. Please use the versions of the API that accept an `async_context`
1962 <!-- YAML
1964   - version: v10.0.0
1965     pr-url: https://github.com/nodejs/node/pull/18666
1967   - version: v0.3.7
1968     description: Documentation-only deprecation.
1969 -->
1978 ### DEP0101: `--with-lttng`
1979 <!-- YAML
1981   - version: v10.0.0
1982     pr-url: https://github.com/nodejs/node/pull/18982
1983     description: End-of-Life.
1984 -->
1986 Type: End-of-Life
1988 The `--with-lttng` compile-time option has been removed.
1992 <!-- YAML
1994   - version: v10.0.0
1995     pr-url: https://github.com/nodejs/node/pull/18395
1996     description: End-of-Life.
1997 -->
1999 Type: End-of-Life
2007 <!-- YAML
2009   - version: v10.9.0
2010     pr-url: https://github.com/nodejs/node/pull/22004
2012   - version: v10.0.0
2013     pr-url: https://github.com/nodejs/node/pull/18415
2014     description: Documentation-only deprecation.
2015 -->
2017 Type: Documentation-only (supports [`--pending-deprecation`][])
2023 `process.binding()` API ([DEP0111](#DEP0111)).
2027 <!-- YAML
2029   - version: v10.0.0
2030     pr-url: https://github.com/nodejs/node/pull/18990
2031     description: Documentation-only deprecation.
2032 -->
2034 Type: Documentation-only (supports [`--pending-deprecation`][])
2036 When assigning a non-string property to [`process.env`][], the assigned value is
2044 <!-- YAML
2046   - version: v11.0.0
2047     pr-url: https://github.com/nodejs/node/pull/19941
2048     description: End-of-Life.
2049   - version: v10.0.0
2050     pr-url: https://github.com/nodejs/node/pull/19353
2052 -->
2054 Type: End-of-Life
2057 [`decipher.final()`][]. This API has been removed, and it is recommended to use
2062 <!-- YAML
2064   - version: v11.0.0
2065     pr-url: https://github.com/nodejs/node/pull/22089
2067   - version: v10.0.0
2068     pr-url: https://github.com/nodejs/node/pull/19343
2069     description: Documentation-only deprecation.
2070 -->
2083 <!-- YAML
2085   - version: v11.0.0
2086     pr-url: https://github.com/nodejs/node/pull/20736
2087     description: End-of-Life.
2088   - version: v10.0.0
2089     pr-url: https://github.com/nodejs/node/pull/19403
2091 -->
2093 Type: End-of-Life
2095 This was an undocumented helper function not intended for use outside Node.js
2100 <!-- YAML
2102   - version: v11.0.0
2103     pr-url: https://github.com/nodejs/node/pull/23308
2105   - version: v10.0.0
2106     pr-url: https://github.com/nodejs/node/pull/19414
2107     description: Documentation-only deprecation.
2108 -->
2114 read by the engine, but is inconsistent with other streams in Node.js that
2119 <!-- YAML
2121   - version: v11.0.0
2122     pr-url: https://github.com/nodejs/node/pull/20270
2124 -->
2131 accepted by the legacy `url.parse()` API. The mentioned APIs now use the WHATWG
2137 <!-- YAML
2139   - version: v10.6.0
2140     pr-url: https://github.com/nodejs/node/pull/20300
2141     description: Documentation-only deprecation.
2142 -->
2144 Type: Documentation-only
2151 <!-- YAML
2153   - version: v10.9.0
2154     pr-url: https://github.com/nodejs/node/pull/22004
2155     description: Documentation-only deprecation.
2156   - version: v11.12.0
2157     pr-url: https://github.com/nodejs/node/pull/26500
2158     description: Added support for `--pending-deprecation`.
2159 -->
2161 Type: Documentation-only (supports [`--pending-deprecation`][])
2163 `process.binding()` is for use by Node.js internal code only.
2167 <!-- YAML
2169   - version: v11.0.0
2170     pr-url: https://github.com/nodejs/node/pull/22011
2172 -->
2177 accessed outside of Node.js core: `Socket.prototype._handle`,
2185 <!-- YAML
2187   - version: v12.0.0
2188     pr-url: https://github.com/nodejs/node/pull/26249
2189     description: End-of-Life.
2190   - version: v11.0.0
2191     pr-url: https://github.com/nodejs/node/pull/22126
2193 -->
2195 Type: End-of-Life
2202 <!-- YAML
2204   - version: v12.0.0
2205     pr-url: https://github.com/nodejs/node/pull/25338
2206     description: End-of-Life.
2207   - version: v11.0.0
2208     pr-url: https://github.com/nodejs/node/pull/22501
2210 -->
2212 Type: End-of-Life
2215 of Node.js core and was removed.
2219 <!-- YAML
2221   - version: v11.0.0
2222     pr-url:
2223       - https://github.com/nodejs/node/pull/22519
2224       - https://github.com/nodejs/node/pull/23017
2225     description: Added documentation-only deprecation
2226                  with `--pending-deprecation` support.
2227 -->
2229 Type: Documentation-only (supports [`--pending-deprecation`][])
2231 In recent versions of Node.js, there is no difference between
2238 ### DEP0116: Legacy URL API
2239 <!-- YAML
2241   - version: v11.0.0
2242     pr-url: https://github.com/nodejs/node/pull/22715
2243     description: Documentation-only deprecation.
2244 -->
2246 Type: Documentation-only
2248 The [Legacy URL API][] is deprecated. This includes [`url.format()`][],
2250 use the [WHATWG URL API][] instead.
2254 <!-- YAML
2256   - version: v12.0.0
2257     pr-url: https://github.com/nodejs/node/pull/27011
2258     description: End-of-Life.
2259   - version: v11.0.0
2260     pr-url: https://github.com/nodejs/node/pull/22747
2262 -->
2264 Type: End-of-Life
2266 Previous versions of Node.js exposed handles to internal native objects through
2274 <!-- YAML
2276   - version: v11.0.0
2277     pr-url: https://github.com/nodejs/node/pull/23173
2279 -->
2283 Previous versions of Node.js supported `dns.lookup()` with a falsy host name
2286 It will become an error in future versions of Node.js.
2289 ### DEP0119: `process.binding('uv').errname()` private API
2290 <!-- YAML
2292   - version: v11.0.0
2293     pr-url: https://github.com/nodejs/node/pull/23597
2294     description: Documentation-only deprecation.
2295 -->
2297 Type: Documentation-only (supports [`--pending-deprecation`][])
2304 <!-- YAML
2306   - version: v12.0.0
2307     pr-url: https://github.com/nodejs/node/pull/24862
2308     description: End-of-Life.
2309   - version: v11.0.0
2310     pr-url: https://github.com/nodejs/node/pull/22485
2312 -->
2314 Type: End-of-Life
2316 Windows Performance Counter support has been removed from Node.js. The
2324 <!-- YAML
2326   - version: v12.0.0
2327     pr-url: https://github.com/nodejs/node/pull/23760
2329 -->
2337 <https://github.com/nodejs/node/issues/18391>
2341 <!-- YAML
2343   - version: v12.0.0
2344     pr-url: https://github.com/nodejs/node/pull/23820
2346 -->
2354 <!-- YAML
2356   - version: v12.0.0
2357     pr-url: https://github.com/nodejs/node/pull/23329
2359 -->
2368 <!-- YAML
2370   - version: v12.0.0
2371     pr-url: https://github.com/nodejs/node/pull/26260
2373 -->
2381 <!-- YAML
2383   - version: v12.0.0
2384     pr-url: https://github.com/nodejs/node/pull/26245
2386 -->
2394 <!-- YAML
2396   - version: v11.14.0
2397     pr-url: https://github.com/nodejs/node/pull/26760
2399 -->
2405 If re-referencing the timeout is necessary, [`timeout.ref()`][] can be used
2406 with no performance impact since Node.js 10.
2410 <!-- YAML
2412   - version: v11.14.0
2413     pr-url: https://github.com/nodejs/node/pull/26760
2415 -->
2422 with no performance impact since Node.js 10.
2426 <!-- YAML
2428   - version: v12.0.0
2429     pr-url: https://github.com/nodejs/node/pull/26823
2430     description: Documentation-only.
2431 -->
2433 Type: Documentation-only (supports [`--pending-deprecation`][])
2435 Modules that have an invalid `main` entry (e.g., `./does-not-exist.js`) and
2438 Node.js versions.
2442 <!-- YAML
2444   - version: v11.14.0
2445     pr-url: https://github.com/nodejs/node/pull/26982
2446     description: Documentation-only.
2447 -->
2449 Type: Documentation-only
2457 <!-- YAML
2459   - version: v12.2.0
2460     pr-url: https://github.com/nodejs/node/pull/27405
2461     description: Documentation-only.
2462 -->
2464 Type: Documentation-only
2470 <!-- YAML
2472   - version: v12.3.0
2473     pr-url: https://github.com/nodejs/node/pull/27498
2474     description: Documentation-only.
2475 -->
2477 Type: Documentation-only
2479 The legacy HTTP parser, used by default in versions of Node.js prior to 12.0.0,
2481 [`--http-parser=legacy`][] command-line flag.
2485 <!-- YAML
2487   - version: v12.5.0
2488     pr-url: https://github.com/nodejs/node/pull/28021
2490 -->
2499 <!-- YAML
2501   - version: v12.12.0
2502     pr-url: https://github.com/nodejs/node/pull/29015
2503     description: Documentation-only deprecation.
2504 -->
2506 Type: Documentation-only
2513 <!-- YAML
2515   - version: v12.12.0
2516     pr-url: https://github.com/nodejs/node/pull/29781
2517     description: Documentation-only deprecation.
2518 -->
2519 Type: Documentation-only (supports [`--pending-deprecation`][])
2522 an officially supported API.
2526 <!-- YAML
2528   - version: v12.16.0
2529     pr-url: https://github.com/nodejs/node/pull/28679
2530     description: Documentation-only deprecation.
2531 -->
2533 Type: Documentation-only
2547 <!-- YAML
2549   - version:
2550     - v12.19.0
2551     - v14.0.0
2552     pr-url: https://github.com/nodejs/node/pull/32499
2553     description: Documentation-only deprecation.
2554 -->
2556 Type: Documentation-only
2558 Calling `process.umask()` with no argument causes the process-wide umask to be
2560 potential security vulnerability. There is no safe, cross-platform alternative
2561 API.
2565 <!-- YAML
2567   - version:
2568     - v12.19.0
2569     - v14.6.0
2570     pr-url: https://github.com/nodejs/node/pull/32217
2571     description: Documentation-only deprecation.
2572 -->
2574 Type: Documentation-only
2598 [`--http-parser=legacy`]: cli.html#cli_http_parser_library
2599 [`--pending-deprecation`]: cli.html#cli_pending_deprecation
2600 [`--throw-deprecation`]: cli.html#cli_throw_deprecation
2701 [Legacy URL API]: url.html#url_legacy_url_api
2702 [NIST SP 800-38D]: https://nvlpubs.nist.gov/nistpubs/Legacy/SP/nistspecialpublication800-38d.pdf
2703 [RFC 6066]: https://tools.ietf.org/html/rfc6066#section-3
2704 [WHATWG URL API]: url.html#url_the_whatwg_url_api