feat: `Deno.{stdin,stdout,stderr}.isTerminal()`, deprecate `Deno.isatty()` (#22011)

This change:
1. Implements `Deno.stdin.isTerminal()`, `Deno.stdout.isTerminal()` and
`Deno.stderr.isTerminal()`.
2. Deprecates `Deno.isatty()` for removal in Deno v2, in favour of the
above instance methods.
3. Replaces use of `Deno.isatty()` with the above instance methods.

Related #21995

---------

Co-authored-by: Bartek Iwańczuk <biwanczuk@gmail.com>
Co-authored-by: Divy Srivastava <dj.srivastava23@gmail.com>

1 files changed, 5 insertions, 5 deletions

diff --git a/cli/tests/unit_node/tty_test.ts b/cli/tests/unit_node/tty_test.ts
index c393da5b3..8e2f66f9e 100644
--- a/cli/tests/unit_node/tty_test.ts
+++ b/cli/tests/unit_node/tty_test.ts
@@ -6,9 +6,9 @@ import { isatty } from "node:tty";
 import process from "node:process";
 
 Deno.test("[node/tty isatty] returns true when fd is a tty, false otherwise", () => {
-  assert(Deno.isatty(Deno.stdin.rid) === isatty(Deno.stdin.rid));
-  assert(Deno.isatty(Deno.stdout.rid) === isatty(Deno.stdout.rid));
-  assert(Deno.isatty(Deno.stderr.rid) === isatty(Deno.stderr.rid));
+  assert(Deno.stdin.isTerminal() === isatty(Deno.stdin.rid));
+  assert(Deno.stdout.isTerminal() === isatty(Deno.stdout.rid));
+  assert(Deno.stderr.isTerminal() === isatty(Deno.stderr.rid));
 
   const file = Deno.openSync("README.md");
   assert(!isatty(file.rid));
@@ -32,6 +32,6 @@ Deno.test("[node/tty isatty] returns false for irrelevant values", () => {
 });
 
 Deno.test("[node/tty WriteStream.isTTY] returns true when fd is a tty", () => {
-  assert(Deno.isatty(Deno.stdin.rid) === process.stdin.isTTY);
-  assert(Deno.isatty(Deno.stdout.rid) === process.stdout.isTTY);
+  assert(Deno.stdin.isTerminal() === process.stdin.isTTY);
+  assert(Deno.stdout.isTerminal() === process.stdout.isTTY);
 });