minimist は、Node.js 向けの軽量・ミニマリストな CLI 引数パーサエンジンです。
基本的な使い方
const minimist = require('minimist');
const args = minimist(process.argv.slice(2), {
string: ['lang'], // Always parse --lang as a string
boolean: ['verbose'], // Always parse --verbose as a boolean
alias: { v: 'verbose', l: 'lang' }
});
console.log(args);
全オプションリファレンス
const args = minimist(process.argv.slice(2), {
string: ['lang'], // Strings that preserve leading zeros
boolean: ['pager', 'help'], // Treat flags as boolean switches
alias: { h: 'help', p: 'pager' }, // Short-to-long alias mapping
default: { lang: 'en', pager: true }, // Default values if omitted
'--': true, // Store arguments after '--' in args['--']
stopEarly: true, // Stop parsing flags at the first non-option
unknown: (arg) => { // Callback triggered when an unrecognized flag is seen
console.error(`Unknown flag: ${arg}`);
return false;
}
});
解析結果の出力構造
次のコマンドを実行すると：
node cli.js --lang es --no-pager -v input.txt
解析結果のオブジェクトは次のようになります：
{
lang: 'es',
pager: false,
v: true,
verbose: true,
_: ['input.txt'] // Positional non-flag arguments
}