From 5a2e2fc32e7e881fb4dbb14f90104a0f42cc79d0 Mon Sep 17 00:00:00 2001
From: Taeuk Ha <tomcat0519@naver.com>
Date: Wed, 5 Aug 2026 21:48:22 +0900
Subject: [PATCH] doc: add missing ESM examples to DEP0202 and DEP0207

DEP0202 and DEP0207 each have two consecutive cjs code blocks with no
corresponding mjs block, breaking the cjs/mjs pairing convention used
elsewhere in this file.

Signed-off-by: Taeuk Ha <tomcat0519@naver.com>
---
 doc/api/deprecations.md | 52 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)

diff --git a/doc/api/deprecations.md b/doc/api/deprecations.md
index 0868f0fae4c1..799462bf7761 100644
--- a/doc/api/deprecations.md
+++ b/doc/api/deprecations.md
@@ -4541,6 +4541,17 @@ const server = http2.createSecureServer({
 });
 ```
 
+```mjs
+import { createSecureServer } from 'node:http2';
+
+// Deprecated
+const server = createSecureServer({
+  allowHTTP1: true,
+  Http1IncomingMessage: MyIncomingMessage,
+  Http1ServerResponse: MyServerResponse,
+});
+```
+
 ```cjs
 // Use this instead
 const server = http2.createSecureServer({
@@ -4552,6 +4563,19 @@ const server = http2.createSecureServer({
 });
 ```
 
+```mjs
+import { createSecureServer } from 'node:http2';
+
+// Use this instead
+const server = createSecureServer({
+  allowHTTP1: true,
+  http1Options: {
+    IncomingMessage: MyIncomingMessage,
+    ServerResponse: MyServerResponse,
+  },
+});
+```
+
 ### DEP0203: Passing `CryptoKey` to `node:crypto` APIs
 
 <!-- YAML
@@ -4671,6 +4695,15 @@ server.on('stream', (stream) => {
 });
 ```
 
+```mjs
+// Deprecated
+server.on('stream', (stream) => {
+  stream.on('aborted', () => {
+    // Stream was closed while the writable was still open.
+  });
+});
+```
+
 ```cjs
 // Use this instead
 server.on('stream', (stream) => {
@@ -4690,6 +4723,25 @@ server.on('stream', (stream) => {
 });
 ```
 
+```mjs
+// Use this instead
+server.on('stream', (stream) => {
+  // Read-side abort: peer cancelled before sending END_STREAM.
+  stream.on('error', (err) => {
+    if (err.code === 'ERR_HTTP2_STREAM_ABORTED' ||
+        err.code === 'ERR_HTTP2_STREAM_ERROR') {
+      // Peer cancelled the request mid-stream.
+    }
+  });
+  // Write-side abort: our response didn't fully send before close.
+  stream.on('close', () => {
+    if (!stream.writableFinished) {
+      // Writes were aborted (peer cancel, local destroy, etc.).
+    }
+  });
+});
+```
+
 The same patterns apply to the compatibility API (`req` / `res` on
 `http2.createServer((req, res) => …)`). On the read-side, errors on the
 underlying stream are emitted from `req`. On the write-side you can use