JavaScript SDK: مرجع التخزين
كل طريقة تدير الدلاء والكائنات، مع توقيعها.
6 د قراءة·المستوى مرجع·تمت المراجعة في 12/10/2026
تم إنشاء هذا النص الإنجليزي تلقائيًا من النص الأصلي الفرنسي ولم تتم مراجعته بعد.
تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.
#
فئة
خدمة التخزين
| الطريقة | الوصف |
|---|---|
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 لملف في مجموعة. |
#
فئة
StorageBucketClient
الوصول إلى العميل ضمن مجموعة محددة (تكافؤ 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 العام لملف في هذه المجموعة. |
#
فئة
BlobDownloadBuilder
تنزيل كسول (Blob افتراضيًا).
| الطريقة | الوصف |
|---|---|
asStream(): StreamDownloadBuilder | التبديل إلى القراءة المتدفقة: تصبح النتيجة ReadableStream بدلاً من Blob المحملة في الذاكرة. |
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); يتم حفظ النتيجة. |
#
فئة
StreamDownloadBuilder
التدفق المتغير - 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، لذلك لا يمكن أن تنحرف عن التعليمات البرمجية المنشورة. للحصول على أمثلة عملية، اقرأ الأدلة.
آخر تحديث · 12/10/2026