本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 `codebuild-glob-search` CLI 命令
<a name="parallel-test-glob-search"></a>

AWS CodeBuild 提供稱為 的內建 CLI 工具`codebuild-glob-search`，可讓您根據一或多個 glob 模式搜尋工作目錄中的檔案。當您想要對專案中的特定檔案或目錄執行測試時，此工具特別有用。

## Usage
<a name="parallel-test-glob-search.usage"></a>

`codebuild-glob-search` CLI 具有下列用量語法：

```
codebuild-glob-search <glob_pattern1> [<glob_pattern2> ...]
```
+ `<glob_pattern1>`、 `<glob_pattern2>`等：與工作目錄中的檔案相符的一或多個 glob 模式。
+ `*`：符合任何字元序列 （路徑分隔符號除外）。
+ `**`：符合任何字元序列 （包括路徑分隔符號）。

**注意**  
確定 glob 字串有引號。若要檢查模式比對的結果，請使用 `echo`命令。  

```
version: 0.2

phases:
  build:
    commands:
      - echo $(codebuild-glob-search '**/__tests__/*.js')
      - codebuild-glob-search '**/__tests__/*.js' | xargs -n 1 echo
```

## Output
<a name="parallel-test-glob-search.output"></a>

CLI 將輸出符合所提供 glob 模式的檔案路徑換行分隔清單。傳回的檔案路徑將相對於工作目錄。

如果找不到符合所提供模式的檔案，CLI 會輸出一則訊息，指出找不到檔案。

請注意，由於任何指定模式而找到的目錄將從搜尋結果中排除。

## 範例
<a name="parallel-test-glob-search.example"></a>

如果您只想要搜尋測試目錄及其子目錄中具有 `.js` 副檔名的檔案，您可以搭配 CLI `codebuild-glob-search` 使用下列命令：

```
codebuild-glob-search '**/__tests__/*.js'
```

此命令將搜尋`__tests__`目錄及其子目錄中具有`.js`副檔名的所有檔案，如 模式所示。