目錄
npm-search
選擇 CLI 版本
目錄
概要
npm search [search terms ...]aliases: find, s, se
注意:此指令不認識工作區。
說明
在登錄檔中搜尋符合搜尋字詞的套件。 npm search
會針對登錄檔中所有檔案的套件中繼資料執行線性、遞增、詞彙順序搜尋。如果您的終端機支援色彩,它會進一步在結果中突顯比對結果。這可以用設定項目 color
來停用
此外,使用 --searchopts
和 --searchexclude
選項配對更多搜尋字詞,將會包含和排除進一步的模式。 --searchopts
和標準搜尋字詞之間的主要差異在於,前者不會在輸出中突顯結果,而且您可以使用它們進行更細緻的篩選。此外,您可以在設定中新增這兩個選項,以變更預設搜尋篩選行為。
搜尋也允許在搜尋結果中鎖定維護者,方法是在他們的 npm 使用者名稱前面加上 =
。
如果一個字詞以 /
開頭,它會被解讀為正規表示法,並支援標準的 JavaScript RegExp 語法。在這種情況下,搜尋會忽略尾隨的 /
。(請注意,你必須在大部分 shell 中跳脫或引用許多正規表示法字元。)
設定
long
- 預設值:false
- 類型:布林值
在 ls
、search
和 help-search
中顯示延伸資訊。
json
- 預設值:false
- 類型:布林值
是否輸出 JSON 資料,而非正常的輸出。
- 在
npm pkg set
中,它會在將設定值儲存到package.json
之前,使用 JSON.parse() 來分析設定值。
並非所有 npm 指令都支援。
color
- 預設值:true,除非 NO_COLOR 環境變數設定為「0」以外的值
- 類型:「always」或布林值
如果為 false,則永遠不顯示色彩。如果為 "always"
,則永遠顯示色彩。如果為 true,則只為 tty 檔案描述符列印色彩碼。
parseable
- 預設值:false
- 類型:布林值
從寫入標準輸出的指令中輸出可解析的結果。對於 npm search
,這將會是 tab 分隔的表格格式。
description
- 預設值:true
- 類型:布林值
在 npm search
中顯示說明
searchlimit
- 預設值:20
- 類型:數字
限制搜尋結果的項目數量。完全不會套用於舊版搜尋。
searchopts
- 預設值:""
- 類型:字串
永遠傳遞給搜尋的空格分隔選項。
searchexclude
- 預設值:""
- 類型:字串
限制搜尋結果的空格分隔選項。
registry
- 預設值:"https://registry.npmjs.org/"
- 類型:URL
npm 登錄的基礎 URL。
prefer-online
- 預設值:false
- 類型:布林值
如果為 true,將強制檢查快取資料的過時性,讓 CLI 立即尋找更新,即使是新的套件資料。
prefer-offline
- 預設值:false
- 類型:布林值
如果為 true,將略過檢查快取資料的過時性,但會從伺服器要求遺失的資料。若要強制完全離線模式,請使用 --offline
。
offline
- 預設值:false
- 類型:布林值
強制離線模式:安裝期間不會進行任何網路請求。若要允許 CLI 填入遺失的快取資料,請參閱 --prefer-offline
。