npm-install-ci-test

使用全新狀態安裝專案並執行測試

選擇 CLI 版本

概要

npm install-ci-test
aliases: cit, clean-install-test, sit

說明

此指令會立即執行 npm ci 之後再執行 npm test

組態

install-strategy

  • 預設值:「hoisted」
  • 類型:「hoisted」、「nested」、「shallow」或「linked」

設定在 node_modules 中安裝套件的策略。hoisted(預設值):在頂層安裝非重複套件,並在目錄結構中視需要安裝重複套件。nested:(以前稱為 --legacy-bundling)就地安裝,不進行提升。shallow(以前稱為 --global-style)僅在頂層安裝直接依賴項。linked:(實驗性質)安裝在 node_modules/.store 中,就地連結,不提升。

legacy-bundling

  • 預設值:false
  • 類型:布林值
  • 已棄用:此選項已棄用,建議改用 --install-strategy=nested

與其在 node_modules 中提升套件安裝,不如以依賴套件的方式安裝套件。這可能會導致目錄結構非常深,而且會重複安裝套件,因為沒有進行重複資料刪除。設定 --install-strategy=nested

global-style

  • 預設值:false
  • 類型:布林值
  • 已棄用:此選項已棄用,建議改用 --install-strategy=shallow

僅在頂層 node_modules 中安裝直接依賴項,但提升較深層的依賴項。設定 --install-strategy=shallow

omit

  • 預設值:如果 NODE_ENV 環境變數設定為「production」,則為「dev」,否則為空。
  • 類型:「dev」、「optional」或「peer」(可設定多次)

從磁碟上的安裝樹中省略的依賴項類型。

請注意,這些依賴項仍然會解析並新增到 package-lock.jsonnpm-shrinkwrap.json 檔案中。它們只是不會實際安裝在磁碟上。

如果套件類型同時出現在 --include--omit 清單中,則會包含該套件。

如果省略清單中包含 'dev',則會將 NODE_ENV 環境變數設定為 'production',以適用於所有生命週期指令碼。

include

  • 預設值
  • 類型:「prod」、「dev」、「optional」或「peer」(可設定多次)

允許定義要安裝的依賴項類型的選項。

這是 --omit=<type> 的反向操作。

--include 中指定的依賴類型不會被省略,無論在命令列中指定省略/包含的順序為何。

strict-peer-deps

  • 預設值:false
  • 類型:布林值

如果設定為 true,且未設定 --legacy-peer-deps,則任何衝突的 peerDependencies 都會被視為安裝失敗,即使 npm 可以根據非同儕依賴關係合理猜測適當的解決方案。

預設情況下,依賴圖中深層的衝突 peerDependencies 將使用最近的非同儕依賴規格來解決,即使這樣做會導致某些套件接收超出其套件的 peerDependencies 物件中設定的範圍的同儕依賴關係。

當執行此類覆寫時,會列印警告,說明衝突和涉及的套件。如果設定 --strict-peer-deps,則此警告會被視為失敗。

foreground-scripts

  • 預設值:false,除非使用 npm packnpm publish,其預設值為 true
  • 類型:布林值

在前景處理中執行已安裝套件的所有建置腳本(即 preinstallinstallpostinstall)腳本,與主 npm 處理共用標準輸入、輸出和錯誤。

請注意,這通常會使安裝執行速度變慢,且會產生更多雜訊,但對於除錯很有用。

ignore-scripts

  • 預設值:false
  • 類型:布林值

如果為 true,npm 就不會執行在 package.json 檔案中指定的腳本。

請注意,明確用於執行特定腳本的命令,例如 npm startnpm stopnpm restartnpm testnpm run-script,如果設定了 ignore-scripts,仍會執行其預期的腳本,但不會執行任何前置或後置腳本。

audit

  • 預設值:true
  • 類型:布林值

當「true」時,將稽核報告與目前的 npm 指令一起提交至預設登錄程式和所有為範圍設定的登錄程式。有關提交內容的詳細資訊,請參閱 npm audit 的文件。

  • 預設值:true
  • 類型:布林值

指示 npm 為套件可執行檔建立符號連結(或 Windows 上的 .cmd shim)。

設為 false 以不執行此動作。這可用於解決某些檔案系統不支援符號連結的事實,即使在表面上是 Unix 系統。

fund

  • 預設值:true
  • 類型:布林值

當「true」時,在每個 npm install 結尾顯示訊息,確認正在尋找資金的相依項數量。有關詳細資訊,請參閱 npm fund

dry-run

  • 預設值:false
  • 類型:布林值

表示您不希望 npm 進行任何變更,並且它只應報告它會執行的動作。這可以傳遞給任何修改您當地安裝的指令,例如 installupdatededupeuninstall,以及 packpublish

注意:其他網路相關指令不會遵守此設定,例如 dist-tagsowner 等。

workspace

  • 預設值
  • 類型:字串(可設定多次)

啟用在目前專案設定的工作空間背景下執行指令,同時透過僅執行此設定選項所定義的工作空間進行篩選。

workspace 設定的有效值為

  • 工作空間名稱
  • 工作空間目錄路徑
  • 父工作空間目錄路徑(將選取該資料夾內的所有工作空間)

當設定為 npm init 指令時,這可能會設定為尚未存在的資料夾的工作空間,以建立資料夾並將其設定為專案內全新的工作空間。

此值不會匯出至子程式的環境。

workspaces

  • 預設:null
  • 類型:null 或布林

設為 true 以在所有設定的工作空間背景下執行指令。

明確地將此設定為 false,會導致 install 等指令完全忽略工作區。未明確設定時

  • 操作 node_modules 樹狀結構的指令(安裝、更新等)會將工作區連結到 node_modules 資料夾。- 執行其他操作的指令(測試、執行、發布等)會在根目錄專案上執行,除非workspace 設定檔中指定一個或多個工作區。

此值不會匯出至子程式的環境。

include-workspace-root

  • 預設值:false
  • 類型:布林值

在為指令啟用工作區時,請包含工作區根目錄。

當為 false 時,透過 workspace 設定檔指定個別工作區,或透過 workspaces 旗標指定所有工作區,會導致 npm 僅在指定的工作區上執行,而不在根目錄專案上執行。

此值不會匯出至子程式的環境。

  • 預設值:false
  • 類型:布林值

設定時,file: 協定相依項會打包並安裝為一般相依項,而不是建立符號連結。此選項對工作區沒有影響。

另請參閱