/inq-input

Primary LanguageJavaScriptMIT LicenseMIT

@inquirer/input

Interactive free text input component for command line interfaces. Supports validation, filtering, transformation, etc.

Input prompt

Installation

npm install @inquirer/input

yarn add @inquirer/input

Usage

import input from '@inquirer/input';

const answer = await input({ message: 'Enter your name' });

Options

Property Type Required Description
message string yes The question to ask
default string no Default value if no answer is provided (clear it by pressing backspace)
transformer (string, { isFinal: boolean }) => string no Transform/Format the raw value entered by the user. Once the prompt is completed, isFinal will be true. This function is purely visual; to modify the answer, use the filter option.
validate string => boolean | string | Promise<string | boolean> no On submit, validate the filtered answered content. When returning a string, it'll be used as the error message displayed to the user. Note: returning a rejected promise, we'll assume a code error happened and crash.

License

Copyright (c) 2019 Simon Boudrias (twitter: @vaxilart) Licensed under the MIT license.