From 5831aecf60fc16ebe34093d6f56b46af90bc9597 Mon Sep 17 00:00:00 2001
From: Samuel Williams <samuel.williams@shopify.com>
Date: Fri, 26 Jun 2026 16:05:18 +1200
Subject: [PATCH] tty: add raw-vt and io raw modes

---
 doc/api/tty.md                              | 30 ++++++++++++++---
 lib/tty.js                                  | 24 +++++++++++---
 src/tty_wrap.cc                             | 10 ++++--
 test/pseudo-tty/test-set-raw-mode-modes.js  | 36 +++++++++++++++++++++
 test/pseudo-tty/test-set-raw-mode-modes.out |  4 +++
 5 files changed, 92 insertions(+), 12 deletions(-)
 create mode 100644 test/pseudo-tty/test-set-raw-mode-modes.js
 create mode 100644 test/pseudo-tty/test-set-raw-mode-modes.out

diff --git a/doc/api/tty.md b/doc/api/tty.md
index 03f86cd66052fd..b626a9ed6218de 100644
--- a/doc/api/tty.md
+++ b/doc/api/tty.md
@@ -69,12 +69,18 @@ A `boolean` that is always `true` for `tty.ReadStream` instances.
 
 <!-- YAML
 added: v0.7.7
+changes:
+  - version: REPLACEME
+    pr-url: https://github.com/nodejs/node/pull/REPLACEME
+    description: The `mode` argument supports `'raw-vt'` and `'io'`.
 -->
 
-* `mode` {boolean} If `true`, configures the `tty.ReadStream` to operate as a
-  raw device. If `false`, configures the `tty.ReadStream` to operate in its
-  default mode. The `readStream.isRaw` property will be set to the resulting
-  mode.
+* `mode` {boolean|string} If `true` or `'raw-vt'`, configures the
+  `tty.ReadStream` to operate as a raw device. If `'io'`, configures the
+  `tty.ReadStream` to operate in binary-safe I/O mode. If `false`, configures
+  the `tty.ReadStream` to operate in its default mode. The `readStream.isRaw`
+  property will be set to whether the stream is in raw mode, and the
+  `readStream.rawMode` property will be set to the resulting mode.
 * Returns: {this} The read stream instance.
 
 Allows configuration of `tty.ReadStream` so that it operates as a raw device.
@@ -86,6 +92,22 @@ characters. <kbd>Ctrl</kbd>+<kbd>C</kbd> will no longer cause a `SIGINT` when
 in this mode. This mode does not affect terminal output processing, such as
 newline translation on Unix terminals.
 
+When in binary-safe I/O mode, terminal output processing is also disabled.
+This corresponds to libuv's `UV_TTY_MODE_IO` mode and is not supported on
+Windows.
+
+### `readStream.rawMode`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* {boolean|string}
+
+The current raw mode for the `tty.ReadStream`. This is `false` when the stream
+is in its default mode, `'raw-vt'` when raw input mode is enabled, and `'io'`
+when binary-safe I/O mode is enabled.
+
 ## Class: `tty.WriteStream`
 
 <!-- YAML
diff --git a/lib/tty.js b/lib/tty.js
index b1a2d3e7a9bc4d..f37dc731d332cc 100644
--- a/lib/tty.js
+++ b/lib/tty.js
@@ -27,7 +27,13 @@ const {
 } = primordials;
 
 const net = require('net');
-const { TTY, isTTY } = internalBinding('tty_wrap');
+const {
+  TTY,
+  UV_TTY_MODE_IO,
+  UV_TTY_MODE_NORMAL,
+  UV_TTY_MODE_RAW_VT,
+  isTTY,
+} = internalBinding('tty_wrap');
 const {
   ErrnoException,
   codes: {
@@ -68,20 +74,28 @@ function ReadStream(fd, options) {
   });
 
   this.isRaw = false;
+  this.rawMode = false;
   this.isTTY = true;
 }
 
 ObjectSetPrototypeOf(ReadStream.prototype, net.Socket.prototype);
 ObjectSetPrototypeOf(ReadStream, net.Socket);
 
-ReadStream.prototype.setRawMode = function(flag) {
-  flag = !!flag;
-  const err = this._handle?.setRawMode(flag);
+ReadStream.prototype.setRawMode = function(mode) {
+  const rawMode = mode === 'io' ? 'io' : (mode ? 'raw-vt' : false);
+  let ttyMode = UV_TTY_MODE_NORMAL;
+  if (rawMode === 'io') {
+    ttyMode = UV_TTY_MODE_IO;
+  } else if (rawMode === 'raw-vt') {
+    ttyMode = UV_TTY_MODE_RAW_VT;
+  }
+  const err = this._handle?.setRawMode(ttyMode);
   if (err) {
     this.emit('error', new ErrnoException(err, 'setRawMode'));
     return this;
   }
-  this.isRaw = flag;
+  this.isRaw = rawMode !== false;
+  this.rawMode = rawMode;
   return this;
 };
 
diff --git a/src/tty_wrap.cc b/src/tty_wrap.cc
index 3086e859a54e61..c605ab2fcc11bc 100644
--- a/src/tty_wrap.cc
+++ b/src/tty_wrap.cc
@@ -68,6 +68,9 @@ void TTYWrap::Initialize(Local<Object> target,
   SetProtoMethod(isolate, t, "setRawMode", SetRawMode);
 
   SetMethodNoSideEffect(context, target, "isTTY", IsTTY);
+  NODE_DEFINE_CONSTANT(target, UV_TTY_MODE_NORMAL);
+  NODE_DEFINE_CONSTANT(target, UV_TTY_MODE_IO);
+  NODE_DEFINE_CONSTANT(target, UV_TTY_MODE_RAW_VT);
 
   Local<Value> func;
   if (t->GetFunction(context).ToLocal(&func) &&
@@ -124,9 +127,10 @@ void TTYWrap::SetRawMode(const FunctionCallbackInfo<Value>& args) {
   // sequences at all on Windows, such as bracketed paste mode.
   // The Node.js readline implementation handles differences between
   // these modes.
-  int err = uv_tty_set_mode(
-      &wrap->handle_,
-      args[0]->IsTrue() ? UV_TTY_MODE_RAW_VT : UV_TTY_MODE_NORMAL);
+  Environment* env = Environment::GetCurrent(args);
+  int mode;
+  if (!args[0]->Int32Value(env->context()).To(&mode)) return;
+  int err = uv_tty_set_mode(&wrap->handle_, static_cast<uv_tty_mode_t>(mode));
   args.GetReturnValue().Set(err);
 }
 
diff --git a/test/pseudo-tty/test-set-raw-mode-modes.js b/test/pseudo-tty/test-set-raw-mode-modes.js
new file mode 100644
index 00000000000000..c2d32cc8540dee
--- /dev/null
+++ b/test/pseudo-tty/test-set-raw-mode-modes.js
@@ -0,0 +1,36 @@
+'use strict';
+require('../common');
+const assert = require('assert');
+const { spawnSync } = require('child_process');
+
+function isOnlcrEnabled() {
+  const { stdout, status } = spawnSync('stty', ['-a'], {
+    encoding: 'utf8',
+    stdio: ['inherit', 'pipe', 'inherit'],
+  });
+
+  assert.strictEqual(status, 0);
+  return /(?:^|[\s;])onlcr(?:[\s;]|$)/.test(stdout);
+}
+
+process.stdin.setRawMode(true);
+console.log(`raw=${isOnlcrEnabled()}`);
+assert.strictEqual(process.stdin.isRaw, true);
+assert.strictEqual(process.stdin.rawMode, 'raw-vt');
+
+process.stdin.setRawMode(false);
+console.log(`normal=${process.stdin.isRaw}`);
+assert.strictEqual(process.stdin.rawMode, false);
+
+process.stdin.setRawMode('raw-vt');
+console.log(`raw-vt=${isOnlcrEnabled()}`);
+assert.strictEqual(process.stdin.isRaw, true);
+assert.strictEqual(process.stdin.rawMode, 'raw-vt');
+
+process.stdin.setRawMode(false);
+process.stdin.setRawMode('io');
+console.log(`io=${isOnlcrEnabled()}`);
+assert.strictEqual(process.stdin.isRaw, true);
+assert.strictEqual(process.stdin.rawMode, 'io');
+
+process.stdin.setRawMode(false);
diff --git a/test/pseudo-tty/test-set-raw-mode-modes.out b/test/pseudo-tty/test-set-raw-mode-modes.out
new file mode 100644
index 00000000000000..f8eee605b9cb55
--- /dev/null
+++ b/test/pseudo-tty/test-set-raw-mode-modes.out
@@ -0,0 +1,4 @@
+raw=true
+normal=false
+raw-vt=true
+io=false