@yarn-tool/is-npx

@yarn-tool/is-npx

檢測當前是否在 NPX/YPX 環境中執行
Detect if running in NPX/YPX environment

安裝 / Install

npm install @yarn-tool/is-npx

或 / or

yarn add @yarn-tool/is-npx

或 / or

pnpm add @yarn-tool/is-npx

使用方式 / Usage

基本用法 / Basic Usage

import { isNpx } from '@yarn-tool/is-npx';

const result = isNpx({
  __dirname: __dirname,
  env: process.env,
  argv: process.argv
});

if (result) {
  console.log('Running in NPX/YPX environment');
} else {
  console.log('Running in normal environment');
}

API

isNpx(opts)

檢測當前是否在 NPX/YPX 環境中。
Detect if currently running in NPX/YPX environment.

參數 / Parameters:

參數 / Parameter	型別 / Type	必填 / Required	說明 / Description
opts	IOptionsDetectNpxInput	是 / Yes	檢測選項 / Detection options
opts.__dirname	string	是 / Yes	當前檔案目錄 / Current file directory
opts.env	Record<string, string>	是 / Yes	環境變數物件 / Environment variables object
opts.argv	string[]	否 / No	命令列參數陣列 / Command line arguments array

回傳值 / Returns: boolean - 是否在 NPX/YPX 環境中 / Whether in NPX/YPX environment

_inNpxPath(__dirname)

檢查路徑是否包含 NPX/YPX 特徵（內部函式）。
Check if path contains NPX/YPX characteristics (internal function).

import { _inNpxPath } from '@yarn-tool/is-npx';

const isNpxPath = _inNpxPath('/some/path/ypx_abc');
console.log(isNpxPath); // true

handleOptionsDetectNpx(opts)

處理並標準化 NPX 檢測選項（內部函式）。
Process and normalize NPX detection options (internal function).

檢測機制 / Detection Mechanism

此模組使用多種策略來檢測 NPX/YPX 環境：

This module uses multiple strategies to detect NPX/YPX environments:

1. 路徑特徵檢測 / Path Characteristic Detection

   • 檢查路徑中是否包含 ypx_、_npx 或 dlx
   • Checks if path contains ypx_, _npx, or dlx

2. PNPM 套件名稱檢測 / PNPM Package Name Detection

   • 檢查環境變數 PNPM_PACKAGE_NAME 是否匹配 NPX/YPX 相關名稱
   • Checks if environment variable PNPM_PACKAGE_NAME matches NPX/YPX related names

3. 原始 is-npx 檢測 / Original is-npx Detection

   • 使用 is-npx 模組進行檢測
   • Uses the is-npx module for detection

授權 / License

ISC