re:re:actable
Урок 061 минута чтения

Что такое TTY и интерактивный CLI?

На этой странице
Кратко

TTY - терминальное устройство. В Node.js можно проверить, запущена ли программа интерактивно в терминале, через process.stdin.isTTY и process.stdout.isTTY.

Вопрос

Что такое TTY и как сделать интерактивный CLI?

Зачем знать про TTY?

CLI-программа может работать в двух режимах:

node cli.js

Интерактивный режим: пользователь вводит данные руками.

cat input.txt | node cli.js

Pipe-режим: программа получает данные из другого процесса.

Проверка

if (process.stdin.isTTY) {
  console.log('Интерактивный ввод');
} else {
  console.log('Данные пришли через pipe');
}

Пример выбора режима

import { readFileSync } from 'node:fs';
import * as readline from 'node:readline/promises';
import { stdin as input, stdout as output } from 'node:process';
 
if (process.stdin.isTTY) {
  const rl = readline.createInterface({ input, output });
  const name = await rl.question('Имя: ');
  console.log(`Привет, ${name}`);
  rl.close();
} else {
  const text = readFileSync(0, 'utf8');
  console.log(text.toUpperCase());
}

Что важно помнить

  • process.stdout.isTTY показывает, подключен ли вывод к терминалу или перенаправлен в файл.
  • Цвета и интерактив отключают, если вывод не TTY, а также при NO_COLOR.
  • util.styleText раскрашивает текст без сторонних библиотек.
  • Raw mode (setRawMode) нужен для чтения отдельных нажатий клавиш.

Мини-шпаргалка

  • TTY означает интерактивный терминал.
  • process.stdin.isTTY помогает отличить ручной ввод от pipe.
  • CLI может поддерживать оба режима.
  • Цветной вывод обычно включают только для TTY.
  • В automated output лучше не добавлять лишние prompts.

Документация

Node.js: TTY, Node.js: util.styleText.

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам