@inquirer/input v2.1.6
@inquirer/input
Interactive free text input component for command line interfaces. Supports validation, filtering, transformation, etc.
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, modify the answer in your code if needed. |
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. |
theme | See Theming | no | Customize look of the prompt. |
Theming
You can theme a prompt by passing a theme
object option. The theme object only need to includes the keys you wish to modify, we'll fallback on the defaults for the rest.
type Theme = {
prefix: string;
spinner: {
interval: number;
frames: string[];
};
style: {
answer: (text: string) => string;
message: (text: string) => string;
error: (text: string) => string;
defaultAnswer: (text: string) => string;
};
};
License
Copyright (c) 2023 Simon Boudrias (twitter: @vaxilart) Licensed under the MIT license.
1 day ago
11 days ago
15 days ago
15 days ago
22 days ago
29 days ago
2 months ago
2 months ago
2 months ago
3 months ago
3 months ago
3 months ago
8 months ago
9 months ago
9 months ago
10 months ago
10 months ago
10 months ago
7 months ago
7 months ago
8 months ago
8 months ago
6 months ago
8 months ago
10 months ago
11 months ago
11 months ago
12 months ago
11 months ago
12 months ago
11 months ago
12 months ago
12 months ago
12 months ago
11 months ago
11 months ago
12 months ago
1 year ago
1 year ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
2 years ago
3 years ago
3 years ago
3 years ago
3 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago