CodeSampleX

Пример

commander 15.0.0: Parse command line options with commander without touching process.argv

Проверенный пример — npm commander 15.0.0: Parse command line options with commander without touching process.argv. Контракт выполнен на node 22 · linux…

sha256:ae82f374c5cce645bfa0fbd914f1f675540b81131e60b0b93130f5caa6b74638

Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла. Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди. MIT-0

Свидетельства выполнения

Заявленное окружение и подписанные запуски разделены, чтобы вы точно видели, что этот образец запускал и где.

Основа свидетельства
Подписанный контракт пройден
Квитанции проверки
3
Ключи подписи, собравшие его
3
Заявленная среда node 22 linux x64 node 22 npm

Среды запусков проверки

Окружение Контракт Этапы Запуск
node 22 · linux alpine/x64 · docker ed25519:a2ec939a4c60e243 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1		 2026-08-13
node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1		 2026-08-17
node 22 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1node:22-alpine@sha256:c610fcdfb1d5…		 2026-09-08

Кейс

HOW
Цель
Parse command line options with commander without touching process.argv
Пакеты
Символы
  • Command
  • program.option
  • program.parse
Окружение
node 22
Создан
2026-08-13T15:19:24Z

Контракт

  1. build a Command with a value option, a flag and a default
  2. parse an explicit argument array with from: user
  3. assert values, flags and defaults land in opts()
  4. assert positional arguments are still reachable

Файлы

  • csx.json
  • package-lock.json
  • package.json
  • src/index.mjs
  • test/contract.mjs

Скачать артефакт с исходным кодом (tar.gz)

Исходный код

csx.json
{"case":{"caseId":"case:sha256:12b9ee4f453ffcb914628f2a8bda58849d2ef93510e12c01d9971b548155205f","constraints":{"moduleSystem":"esm","runtime":"node"},"contract":["build a Command with a value option, a flag and a default","parse an explicit argument array with from: user","assert values, flags and defaults land in opts()","assert positional arguments are still reachable"],"goal":"Parse command line options with commander without touching process.argv","kind":"HOW","packages":["pkg:npm/commander@15.0.0"],"schemaVersion":1,"symbols":["Command","program.option","program.parse"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","ecosystem":"npm","executionContext":"node","moduleSystem":"esm","os":"linux","packageManager":"npm","runtime":"node","runtimeVersion":"22","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/commander@15.0.0"],"schemaVersion":1,"symbols":["Command","program.option","program.parse"],"verifierAdapter":"node-typescript@1"}
package-lock.json
{
  "name": "csx-sample-commander-parse-options",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "csx-sample-commander-parse-options",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "commander": "15.0.0"
      }
    },
    "node_modules/commander": {
      "version": "15.0.0",
      "resolved": "https://registry.npmjs.org/commander/-/commander-15.0.0.tgz",
      "integrity": "sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==",
      "license": "MIT",
      "engines": {
        "node": ">=22.12.0"
      }
    }
  }
}
package.json
{
  "name": "csx-sample-commander-parse-options",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "dependencies": {
    "commander": "15.0.0"
  }
}
src/index.mjs
import { Command } from 'commander';

// parse(argv) expects a full node argv (argv[0] node, argv[1] script).
// Passing your own array without { from: 'user' } silently eats the first
// two entries — the classic "my first option disappeared" report.
export function parseArgs(argv) {
  const program = new Command();
  program
    .name('csx-demo')
    .argument('[target]', 'what to build', 'all')
    .option('-p, --port <number>', 'port to listen on', '3000')
    .option('-v, --verbose', 'verbose output')
    .exitOverride(); // throw instead of calling process.exit in a library
  program.parse(argv, { from: 'user' });
  return { options: program.opts(), args: program.args };
}
test/contract.mjs
import { strict as assert } from 'node:assert';
import { parseArgs } from '../src/index.mjs';

const explicit = parseArgs(['--port', '8080', '--verbose', 'server']);
assert.equal(explicit.options.port, '8080');
assert.equal(explicit.options.verbose, true);
assert.deepEqual(explicit.args, ['server']);

const defaults = parseArgs([]);
assert.equal(defaults.options.port, '3000'); // declared default
assert.equal(defaults.options.verbose, undefined);
console.log('CONTRACT PASS: commander parsed an explicit argv with from: user');

Исходный сидер

anonymous