commit
리포지토리에 새로운 커밋을 생성해요.
updateRef
가 null
이 아니면 해당 레퍼런스가 이 커밋을 가리키도록 업데이트돼요.
레퍼런스가 직접 레퍼런스가 아니면 직접 레퍼런스로 변환돼요."HEAD"
를 전달하면 현재 브랜치의 HEAD를 이 커밋으로 업데이트해요.
레퍼런스가 존재하지 않으면 새로 생성되며, 존재하는 경우 첫 번째 부모 커밋은 해당 브랜치의 최신 커밋이어야 해요.
시그니처
ts
class Repository {
commit(tree: Tree, message: string, options?: CommitOptions | null | undefined): string;
}
파라미터
- tree필수 · Tree
커밋할 트리예요.
- message필수 · string
커밋 메시지예요.
- optionsnull | CommitOptions
커밋 옵션이에요.
- authorSignaturePayload
작성자 서명이에요. 설정하지 않으면 리포지토리의 기본 서명을 사용해요. 기본 서명이 없으면 오류가 발생해요.
- email필수 · string
작성자의 이메일 주소예요.
- name필수 · string
작성자의 이름이에요.
- timeOptionsSignatureTimeOptions
시간 설정 옵션이에요.
- offsetnumber
시간대 오프셋(분 단위)이에요.
- timestamp필수 · number
Unix epoch(초 단위) 기준의 시간이에요.
- offsetnumber
- email필수 · string
- committerSignaturePayload
커밋 작성자 서명이에요. 설정하지 않으면 리포지토리의 기본 서명을 사용해요. 기본 서명이 없으면 오류가 발생해요.
- email필수 · string
커밋 작성자의 이메일 주소예요.
- name필수 · string
커밋 작성자의 이름이에요.
- timeOptionsSignatureTimeOptions
시간 설정 옵션이에요.
- offsetnumber
시간대 오프셋(분 단위)이에요.
- timestamp필수 · number
Unix epoch(초 단위) 기준의 시간이에요.
- offsetnumber
- email필수 · string
- parentsstring[]
부모 커밋 ID 목록이에요.
- updateRefstring
이 커밋을 가리키도록 업데이트할 레퍼런스 이름이에요. `"HEAD"`를 전달하면 현재 브랜치의 HEAD를 업데이트해요.
- authorSignaturePayload
반환 값
- string
생성된 커밋의 SHA-1 ID를 반환해요.