addAll

작업 디렉터리 내의 파일과 일치하는 인덱스 항목들을 추가 또는 업데이트해요.

시그니처

class Index {
  addAll(pathspecs: string[], options?: IndexAddAllOptions): void;
}

파라미터

• pathspecs필수 · string[]
  

  리포지토리의 작업 디렉터리의 파일들과 매칭될 파일 이름 또는 쉘 glob 패턴의 목록이에요. 매칭되는 각 파일은 인덱스에 추가돼요. (기존 항목은 업데이트되거나, 새 항목이 추가)

• optionsnull | IndexAddAllOptions
  

  인덱스 항목을 추가하거나 업데이트하는데 사용할 옵션이에요.

  • checkPathspecboolean
    

    git add -A와 동일한 동작을 구현하려면 이 옵션을 설정하세요. force를 사용하지 않는 경우, pathspecs 목록에 무시된 파일의 정확한 경로가 포함돼 있다면 에러를 발생시켜요. pathspecs의 각 항목이 디스크상의 파일과 정확히 일치하는 경우, 그 파일이 무시되지 않았거나 이미 index에 있어야 해요. 이 조건을 충족하지 않으면 에러가 반환돼요.

  • disablePathspecMatchboolean
    

    pathspecs는 파일 이름이나 셸 와일드카드 패턴으로, 작업 디렉터리에서 일치하는 파일을 찾아 index에 추가해요(기존 항목을 업데이트하거나 새 항목을 추가). disablePathspecMatch 플래그를 설정하면 와일드카드 패턴을 비활성화하고 정확한 경로 일치 방식으로 동작하게 할 수 있어요.

  • forceboolean
    

    기본적으로 무시된 파일은 추가되지 않아요(addPath와 다름). 하지만 파일이 이미 index에 추적되고 있다면 무시된 상태라도 업데이트돼요. force 플래그를 설정하면 무시 규칙을 검사하지 않고 강제로 추가할 수 있어요.

  • onMatch(args: IndexOnMatchCallbackArgs) => number
    

    콜백 함수를 제공하면, 작업 디렉터리에서 일치하는 각 항목을 index에 추가하거나 업데이트하기 직전에 실행돼요. 콜백이 0을 반환하면 해당 항목이 index에 추가되고, 0보다 큰 값을 반환하면 건너뛰며, 0보다 작은 값을 반환하면 스캔을 중단하고 에러를 반환해요.

에러

• Error
  

  bare 인덱스 인스턴스인 경우 오류가 발생해요.

예제

git add *를 수행:

import { openRepository } from 'es-git';

const repo = await openRepository('.');
const index = repo.index();
index.addAll(['*']);
index.write();