JavaScript SDK: 저장소 참조
서명을 사용하여 버킷과 객체를 관리하는 모든 방법입니다.
6분 읽기·레벨 참조·2026. 10. 12.에 개정됨
이 영어 텍스트는 프랑스어 원본에서 자동으로 생성되었으며 아직 검토되지 않았습니다.
이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.
#
수업
스토리지 서비스
| 방법 | 설명 |
|---|---|
from(bucketId: string): StorageBucketClient | 특정 버킷(DX 패리티 Supabase)으로 범위가 지정된 클라이언트를 반환합니다. |
listBuckets(): Promise<AuraResponse<StorageBucket[]>> | 프로젝트 버킷을 나열합니다. |
getBucket(id: string): Promise<AuraResponse<StorageBucket>> | 식별자로 버킷을 읽습니다. |
createBucket(name: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | 버킷을 생성합니다. public (기본값 false)는 인증 없이 객체를 읽을 수 있게 만듭니다. fileSizeLimit(바이트) 및 allowedMimeTypes는 허용되는 파일을 제한합니다. |
updateBucket(id: string, options?: { public?: boolean; fileSizeLimit?: number; allowedMimeTypes?: string[]; }): Promise<AuraResponse<StorageBucket>> | 기존 버킷을 업데이트합니다(부분 업데이트: 제공된 필드만 전송됨). |
deleteBucket(id: string): Promise<AuraResponse<null>> | 식별자로 버킷을 삭제합니다. |
upload(bucketId: string, path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | 버킷에 파일을 업로드합니다. |
download(bucketId: string, path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | 파일 다운로드가 지연됩니다. |
list(bucketId: string, options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | 버킷의 파일을 나열합니다. |
remove(bucketId: string, paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | 버킷에서 하나 이상의 파일을 삭제합니다. |
copy(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | 버킷 내의 파일을 복사합니다. |
move(bucketId: string, fromPath: string, toPath: string): Promise<AuraResponse<{ key: string; }>> | 버킷 내에서 파일을 이동하거나 이름을 바꿉니다. |
getMetadata(bucketId: string, path: string): Promise<AuraResponse<ObjectMeta>> | 파일 메타데이터를 가져옵니다. |
createSignedUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | 서명된(임시) 다운로드 URL을 생성합니다. |
createSignedUrls(bucketId: string, paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | 한 번의 패스(일괄)로 여러 개의 서명된 URL을 생성합니다. |
createSignedUploadUrl(bucketId: string, path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | 서명된 업로드 URL(미리 서명된 PUT)을 생성합니다. |
getPublicUrl(bucketId: string, path: string, options?: { transform?: ImageTransform; }): string | 버킷의 파일에 대한 URL을 구성합니다. |
#
수업
StorageBucket클라이언트
특정 버킷(DX 패리티 Supabase)으로 범위가 지정된 클라이언트에 액세스합니다.
| 재산 | 설명 |
|---|---|
readonly bucketId: string | 이 클라이언트가 연결된 버킷의 식별자: 모든 메서드가 이 버킷에서 작동합니다. |
| 방법 | 설명 |
|---|---|
upload(path: string, file: Blob | File | ArrayBuffer, options?: { contentType?: string; upsert?: boolean; metadata?: Record<string, string>; }): Promise<AuraResponse<UploadResult>> | 이 버킷에 파일을 업로드하세요. |
download(path: string, options?: { transform?: ImageTransform; }): BlobDownloadBuilder | 이 버킷에서 파일을 다운로드하세요. |
list(options?: { prefix?: string; limit?: number; offset?: number; cursor?: string; }): Promise<AuraResponse<FileEntry[]>> | 이 버킷의 파일을 나열합니다. |
remove(paths: string[], options?: { permanent?: boolean; }): Promise<AuraResponse<null>> | 이 버킷에서 하나 이상의 파일을 삭제합니다. |
createSignedUrl(path: string, expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | 이 버킷에 있는 파일에 대한 임시 서명된 URL을 생성합니다. |
createSignedUrls(paths: string[], expiresInSeconds?: number, options?: { transform?: ImageTransform; }): Promise<AuraResponse<Array<{ path: string; url: string; expires_in: number; } | { path: string; error: AuraError; }>>> | 이 버킷에 대해 한 번의 패스로 여러 개의 서명된 URL을 생성합니다. |
createSignedUploadUrl(path: string, expiresInSeconds?: number, options?: { upsert?: boolean; }): Promise<AuraResponse<{ url: string; expires_in: number; }>> | 미리 서명된 업로드 URL(직접 PUT)을 생성합니다. |
getPublicUrl(path: string, options?: { transform?: ImageTransform; }): { data: { publicUrl: string; }; } | 이 버킷에 있는 파일의 공개 URL을 반환합니다. |
#
수업
Blob다운로드빌더
지연 다운로드(기본적으로 Blob).
| 방법 | 설명 |
|---|---|
asStream(): StreamDownloadBuilder | 스트리밍 읽기로 전환합니다. 결과는 메모리에 로드된 Blob 대신 ReadableStream가 됩니다. |
then<TR1 = AuraResponse<Blob>, TR2 = never>(onfulfilled?: ((v: AuraResponse<Blob>) => TR1 | PromiseLike<TR1>) | null, onrejected?: ((e: unknown) => TR2 | PromiseLike<TR2>) | null): Promise<TR1 | TR2> | 다운로드를 트리거합니다(게으른: 요청은 await에서만 시작됩니다). 결과가 기억됩니다. |
#
수업
스트림다운로드빌더
변형 플럭스 — res.body(ReadableStream).
| 방법 | 설명 |
|---|---|
then<TR1 = AuraResponse<ReadableStream<Uint8Array>>, TR2 = never>(onfulfilled?: ((v: AuraResponse<ReadableStream<Uint8Array>>) => TR1 | PromiseLike<TR1>) | null, onrejected?: ((e: unknown) => TR2 | PromiseLike<TR2>) | null): Promise<TR1 | TR2> | 스트리밍(지연) 다운로드를 트리거합니다. 결과가 기억됩니다. |
생성된 페이지
이 페이지는 SDK의 유형 선언 및 주석에서 생성되므로 게시된 코드에서 표류할 수 없습니다. 실제 사례를 보려면 가이드를 읽어보세요.
마지막 업데이트 · 2026. 10. 12.