PHP 8.2.30
Preview: ordered-options.mjs Size: 1.36 KB
//opt/alt/alt-nodejs20/root/lib/node_modules/npm/node_modules.bundled/@pkgjs/parseargs/examples/ordered-options.mjs

// This is an example of using tokens to add a custom behaviour.
//
// This adds a option order check so that --some-unstable-option
// may only be used after --enable-experimental-options
//
// Note: this is not a common behaviour, the order of different options
// does not usually matter.

import { parseArgs } from '../index.js';

function findTokenIndex(tokens, target) {
  return tokens.findIndex((token) => token.kind === 'option' &&
    token.name === target
  );
}

const experimentalName = 'enable-experimental-options';
const unstableName = 'some-unstable-option';

const options = {
  [experimentalName]: { type: 'boolean' },
  [unstableName]: { type: 'boolean' },
};

const { values, tokens } = parseArgs({ options, tokens: true });

const experimentalIndex = findTokenIndex(tokens, experimentalName);
const unstableIndex = findTokenIndex(tokens, unstableName);
if (unstableIndex !== -1 &&
  ((experimentalIndex === -1) || (unstableIndex < experimentalIndex))) {
  throw new Error(`'--${experimentalName}' must be specified before '--${unstableName}'`);
}

console.log(values);

/* eslint-disable max-len */
// Try the following:
//    node ordered-options.mjs
//    node ordered-options.mjs --some-unstable-option
//    node ordered-options.mjs --some-unstable-option --enable-experimental-options
//    node ordered-options.mjs --enable-experimental-options --some-unstable-option

Directory Contents

Dirs: 0 × Files: 6

Name Size Perms Modified Actions
765 B lrw-r--r-- 2026-02-23 03:24:43
Edit Download
1.05 KB lrw-r--r-- 2026-02-23 03:24:43
Edit Download
1.28 KB lrw-r--r-- 2026-02-23 03:24:43
Edit Download
897 B lrw-r--r-- 2026-02-23 03:24:43
Edit Download
1.36 KB lrw-r--r-- 2026-02-23 03:24:43
Edit Download
540 B lrw-r--r-- 2026-02-23 03:24:43
Edit Download

If ZipArchive is unavailable, a .tar will be created (no compression).