Cloud Storage for Firebase
İşlevler
İşlev | Açıklama |
---|---|
fonksiyon(uygulama, ...) | |
getStorage(uygulama, paketUrl) | İlgili Firebase uygulaması için bir FirebaseStorage örneği alır. |
fonksiyon(depolama, ...) | |
connectStorageEmulator(depolama, ana makine, bağlantı noktası, seçenekler) | Cloud Storage emülatörüyle iletişim kurmak için bu FirebaseStorage örneğini değiştirin. |
ref(depolama; url) | Belirli bir URL için StorageReference döndürür. |
function(ref, ...) | |
deleteObject(ref) | Bu konumdaki nesneyi siler. |
getBlob(ref, maxDownloadSizeBytes) | Nesnenin konumundaki verileri indirir. Nesne bulunamazsa hata döndürür.Bu işlevi kullanmak için uygulamanızın kaynağını Cloud Storage paketinizde beyaz listeye eklemeniz gerekir. https://cloud.google.com/storage/docs/configuring-cors adresine de göz atınBu API, Node'da kullanılamaz. |
getBytes(ref, maxDownloadSizeBytes) | Nesnenin konumundaki verileri indirir. Nesne bulunamazsa hata döndürür.Bu işlevi kullanmak için uygulamanızın kaynağını Cloud Storage paketinizde beyaz listeye eklemeniz gerekir. https://cloud.google.com/storage/docs/configuring-cors adresine de göz atın |
getDownloadURL(ref) | Belirtilen StorageReference için indirme URL'sini döndürür. |
getMetadata(ref) | Bu nesnenin meta verileriyle çözümlenen bir Promise . Bu nesne yoksa veya meta veriler alınamıyorsa taahhüt reddedilir. |
getStream(ref, maxDownloadSizeBytes) | Nesnenin konumundaki verileri indirir. Nesne bulunamazsa bir hata etkinliği oluşturur.Bu API yalnızca Düğüm'de kullanılabilir. |
list(ref, options) | Bu depolama alanı referansı altındaki öğeleri (dosyalar) ve ön ekleri (klasörler) listeleyin.List API yalnızca Firebase Kuralları Sürüm 2'de kullanılabilir.GCS bir anahtar blob deposudur. Firebase Storage, "/" anlamını uygular ayrılmaz bir klasör yapısı vardır. Daha fazla bilgi edinmek için GCS'nin List API'sine göz atın.Firebase Kurallarının Anlamı ile ilgili kurallara uymak için Firebase Storage, yolları "/" ile biten nesneleri desteklemez. ya da art arda iki "/" işareti içermelidir. Firebase Storage List API, desteklenmeyen bu nesneleri filtreler. Pakette çok fazla desteklenmeyen nesne varsa list() başarısız olabilir. |
listAll(ref) | Bu depolama alanı referansı altındaki tüm öğeleri (dosyalar) ve ön ekleri (klasörler) listeleyin.Bu, başka sonuç kalıncaya kadar list() çağrısının tekrar tekrar yapılması için yardımcı bir yöntemdir. Varsayılan sayfalandırma boyutu 1000'dir.Not: Bu işlem çalışırken nesneler değiştirilirse sonuçlar tutarlı olmayabilir.Uyarı: listAll çok fazla sonuç olduğunda çok fazla kaynak tüketebilir. |
updateMetadata(ref, meta veriler) | Bu nesnenin meta verilerini günceller. |
uploadBytes(ref, veriler, meta veriler) | Verileri bu nesnenin konumuna yükler. Yükleme devam ettirilemiyor. |
uploadBytesResumable(ref, veriler, meta veriler) | Verileri bu nesnenin konumuna yükler. Yükleme duraklatılıp devam ettirilebilir ve ilerleme durumu güncellemeleri gösterilir. |
uploadString(ref; değer; biçim; meta veriler) | Bu nesnenin konumuna bir dize yükler. Yükleme devam ettirilemiyor. |
function(storageOrRef, ...) | |
ref(storageOrRef, path) | Varsayılan pakette belirtilen yol için bir StorageReference döndürür. |
Sınıflar
Sınıf | Açıklama |
---|---|
Depolama Hatası | Firebase Storage SDK'sı hata döndürdü. |
Numaralandırmalar
Numaralandırma | Açıklama |
---|---|
StorageErrorCode | StorageError nesneye eklenebilecek hata kodları. |
Arayüzler
Arayüz | Açıklama |
---|---|
FirebaseStorage | Firebase Storage örneği. |
Tam Meta Veri | Salt okunur özellikler de dahil olmak üzere nesne meta verilerinin tamamı grubu. |
ListOptions (Liste Seçenekleri) | list() tarafından kabul edilen seçenekler. |
ListResult | list() tarafından döndürülen sonuç. |
SettableMetadata | İstediğiniz zaman ayarlanabilen nesne meta verileri. |
StorageObserver | Firebase Storage için akış gözlemleyicisi. |
StorageReference | Bir Google Cloud Storage nesnesine başvuruyu temsil eder. Geliştiriciler nesne yüklemenin, indirmenin ve silmenin yanı sıra nesne meta verilerini alabilir/ayarlayabilir. |
UploadMetadata | Yükleme sırasında ayarlanabilen nesne meta verileri. |
UploadResult | Devam ettirilemeyen bir yükleme işleminden döndürülen sonuç. |
UploadTask | Bir nesne yükleme işlemini temsil eder. Yüklemeyi izlemenize ve yönetmenize olanak tanır. |
UploadTaskSnapshot | Yükleme görevinin mevcut durumuyla ilgili verileri içerir. |
Değişkenler
Değişken | Açıklama |
---|---|
Dize Biçimi | Yükleme için olası dize biçimlerinin listesi. |
Tür Takma Adları
Takma Ad yazın | Açıklama |
---|---|
Dize Biçimi | Yükleme için olası dize biçimlerinin listesi. |
Görev Etkinliği | Bir görevde tetiklenen etkinlik. |
Görev Durumu | Çalışmakta olan bir yüklemenin mevcut durumunu temsil eder. |
function(uygulama; ...)
getStorage(uygulama; paketUrl)
İlgili Firebase uygulaması için bir FirebaseStorage örneği alır.
İmza:
export declare function getStorage(app?: FirebaseApp, bucketUrl?: string): FirebaseStorage;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
uygulama | FirebaseUygulaması | FirebaseStorage örneğini alacağınız Firebase uygulaması. |
paketURL'si | dize | Firebase Depolama Paketinizin gs:// URL'si. Geçemezse uygulamanın varsayılan Storage Paketini kullanır. |
Şunu döndürür:
FirebaseStorage örneği.
function(depolama; ...)
ConnectStorageEmulator(depolama; ana makine, bağlantı noktası, seçenekler)
Cloud Storage emülatörüyle iletişim kurmak için bu FirebaseStorage örneğini değiştirin.
İmza:
export declare function connectStorageEmulator(storage: FirebaseStorage, host: string, port: number, options?: {
mockUserToken?: EmulatorMockTokenOptions | string;
}): void;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
depolama | FirebaseStorage | FirebaseStorage örneği |
düzenleyen | dize | Emülatör ana makinesi (ör. localhost) |
bağlantı noktası | sayı | Emülatör bağlantı noktası (ör. 5001) |
seçenekler | { mockUserToken?: EmulatorMockTokenOptions | string; } | Emülatör seçenekleri. options.mockUserToken , Güvenlik Kuralları'nı birim testi için kullanmak üzere örnek kimlik doğrulama jetonudur. |
Şunu döndürür:
geçersiz
ref(depolama; url)
Belirli bir URL için StorageReference döndürür.
İmza:
export declare function ref(storage: FirebaseStorage, url?: string): StorageReference;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
depolama | FirebaseStorage | FirebaseStorage örneğidir. |
url | dize | URL'yi tıklayın. Boşsa kök referansı döndürür. |
Şunu döndürür:
function(ref; ...)
deleteObject(başvuru)
Bu konumdaki nesneyi siler.
İmza:
export declare function deleteObject(ref: StorageReference): Promise<void>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Silinecek nesne için StorageReference |
Şunu döndürür:
Taahhüt<void>
Silme işlemi başarılı olursa çözümlenen bir Promise
.
getBlob(ref; maxDownloadSizeBytes)
Nesnenin konumundaki verileri indirir. Nesne bulunmazsa hata döndürür.
Bu işlevi kullanmak için uygulamanızın kaynağını Cloud Storage paketinizde beyaz listeye eklemeniz gerekir. https://cloud.google.com/storage/docs/configuring-cors adresine de göz atın
Bu API, Düğüm'de kullanılamıyor.
İmza:
export declare function getBlob(ref: StorageReference, maxDownloadSizeBytes?: number): Promise<Blob>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Verilerin indirilmesi gereken StorageReference. |
maxDownloadSizeBytes | sayı | Ayarlanırsa alınabilecek bayt cinsinden izin verilen maksimum boyut. |
Şunu döndürür:
Söz veriyorum<Blob>
Nesnenin baytlarını içeren bir Blob ile çözümlenen bir Promise
getBytes(ref, maxDownloadSizeBytes)
Nesnenin konumundaki verileri indirir. Nesne bulunmazsa hata döndürür.
Bu işlevi kullanmak için uygulamanızın kaynağını Cloud Storage paketinizde beyaz listeye eklemeniz gerekir. https://cloud.google.com/storage/docs/configuring-cors adresine de göz atın
İmza:
export declare function getBytes(ref: StorageReference, maxDownloadSizeBytes?: number): Promise<ArrayBuffer>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Verilerin indirilmesi gereken StorageReference. |
maxDownloadSizeBytes | sayı | Ayarlanırsa alınabilecek bayt cinsinden izin verilen maksimum boyut. |
Şunu döndürür:
Promise<ArrayBuffer>
Nesnenin baytlarını içeren bir Promise
getDownloadURL(ref)
Belirtilen StorageReference için indirme URL'sini döndürür.
İmza:
export declare function getDownloadURL(ref: StorageReference): Promise<string>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | StorageReference öğesini kullanarak indirme URL'sini edinin. |
Şunu döndürür:
Promise<dize>
Bu nesnenin indirme URL'siyle çözümlenen bir Promise
.
getMetadata(ref)
Bu nesnenin meta verileriyle çözümlenen bir Promise
. Bu nesne yoksa veya meta veriler alınamıyorsa taahhüt reddedilir.
İmza:
export declare function getMetadata(ref: StorageReference): Promise<FullMetadata>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Meta verileri almak için StorageReference öğesi |
Şunu döndürür:
Promise<FullMetadata>
getStream(ref; maxDownloadSizeBytes)
Nesnenin konumundaki verileri indirir. Nesne bulunamazsa bir hata etkinliği oluşturur.
Bu API yalnızca Düğüm'de kullanılabilir.
İmza:
export declare function getStream(ref: StorageReference, maxDownloadSizeBytes?: number): ReadableStream;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Verilerin indirilmesi gereken StorageReference. |
maxDownloadSizeBytes | sayı | Ayarlanırsa alınabilecek bayt cinsinden izin verilen maksimum boyut. |
Şunu döndürür:
Okunabilir Akış
Nesnenin verilerini bayt biçiminde içeren bir akış
list(ref; options)
Bu depolama alanı referansı altındaki öğeleri (dosyalar) ve ön ekleri (klasörler) listeleyin.
List API yalnızca Firebase Kuralları Sürüm 2'de kullanılabilir.
GCS, bir anahtar blob deposudur. Firebase Storage, "/" anlamını uygular ayrılmaz bir klasör yapısı vardır. Daha fazla bilgi edinmek için GCS'nin List API'sine göz atın.
Firebase Kurallarının Semantiği'ne uymak için Firebase Storage, yolları "/" ile biten nesneleri desteklemez ya da art arda iki "/" işareti içermelidir. Firebase Storage List API, desteklenmeyen bu nesneleri filtreler. Pakette çok fazla desteklenmeyen nesne varsa list() başarısız olabilir.
İmza:
export declare function list(ref: StorageReference, options?: ListOptions): Promise<ListResult>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | StorageReference öğesini seçin. |
seçenekler | ListOptions (Liste Seçenekleri) | Ayrıntılar için ListOptions bölümüne bakın. |
Şunu döndürür:
Promise<ListResult>
Öğeler ve ön eklerle çözümlenen bir Promise
. prefixes
alt klasörlere ve items
bu klasördeki nesnelere referanslar içeriyor. nextPageToken
, diğer sonuçları almak için kullanılabilir.
listAll(ref)
Bu depolama alanı referansındaki tüm öğeleri (dosyalar) ve ön ekleri (klasörler) listeleyin.
Bu, başka sonuç kalmayana kadar list() çağrısının tekrar tekrar yapılması için yardımcı bir yöntemdir. Sayfalandırma boyutu varsayılan olarak 1.000'dir.
İmza:
export declare function listAll(ref: StorageReference): Promise<ListResult>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | StorageReference öğesini seçin. |
Şunu döndürür:
Promise<ListResult>
Geçerli depolama referansı altındaki tüm öğeler ve ön eklerle çözümlenen bir Promise
. prefixes
alt dizinlere, items
ise bu klasördeki nesnelere referanslar içeriyor. nextPageToken
asla iade edilmez.
updateMetadata(ref, meta veriler)
Bu nesnenin meta verilerini günceller.
İmza:
export declare function updateMetadata(ref: StorageReference, metadata: SettableMetadata): Promise<FullMetadata>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Meta verileri güncellemek için StorageReference öğesini seçin. |
meta veri | SettableMetadata | Nesnenin yeni meta verileri. Yalnızca açıkça ayarlanmış değerler değiştirilir. Bir değerin açıkça null değerine ayarlanması meta verileri kaldırır. |
Şunu döndürür:
Promise<FullMetadata>
Bu nesnenin yeni meta verileriyle çözümlenen bir Promise
.
installBytes(ref; veriler; meta veriler)
Verileri bu nesnenin konumuna yükler. Yükleme devam ettirilemiyor.
İmza:
export declare function uploadBytes(ref: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: UploadMetadata): Promise<UploadResult>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Verilerin yüklenmesi gereken StorageReference |
veri | Blob | Uint8Dizi | DiziArabelleği | Yüklenecek veriler. |
meta veri | UploadMetadata | Yüklenecek verilerin meta verileri. |
Şunu döndürür:
Promise<UploadResult>
UploadResult içeren bir Vaat
UploadBytesResumable(ref; veriler; meta veriler)
Verileri bu nesnenin konumuna yükler. Yükleme duraklatılıp devam ettirilebilir ve ilerleme durumu güncellemeleri gösterilir.
İmza:
export declare function uploadBytesResumable(ref: StorageReference, data: Blob | Uint8Array | ArrayBuffer, metadata?: UploadMetadata): UploadTask;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Verilerin yüklenmesi gereken StorageReference |
veri | Blob | Uint8Dizi | DiziArabelleği | Yüklenecek veriler. |
meta veri | UploadMetadata | Yüklenecek verilerin meta verileri. |
Şunu döndürür:
Yükleme Görevi
installString(ref; değer; biçim; meta veriler)
Bu nesnenin konumuna bir dize yükler. Yükleme devam ettirilemiyor.
İmza:
export declare function uploadString(ref: StorageReference, value: string, format?: StringFormat, metadata?: UploadMetadata): Promise<UploadResult>;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
referans | StorageReference | Dizenin yüklenmesi gereken StorageReference öğesi. |
value | dize | Yüklenecek dize. |
format | Dize Biçimi | Yüklenecek dizenin biçimi. |
meta veri | UploadMetadata | Yüklenecek dizenin meta verileri. |
Şunu döndürür:
Promise<UploadResult>
UploadResult içeren bir Vaat
function(storageOrRef; ...)
ref(storageOrRef; yol)
Varsayılan pakette belirtilen yol için bir StorageReference döndürür.
İmza:
export declare function ref(storageOrRef: FirebaseStorage | StorageReference, path?: string): StorageReference;
Parametreler
Parametre | Tür | Açıklama |
---|---|---|
depolamaVeyaReferansı | FirebaseStorage | StorageReference | FirebaseStorage veya StorageReference'ı seçin. |
yol | dize |
Şunu döndürür:
Dize Biçimi
Yükleme için olası dize biçimlerinin listesi.
İmza:
StringFormat: {
readonly RAW: "raw";
readonly BASE64: "base64";
readonly BASE64URL: "base64url";
readonly DATA_URL: "data_url";
}
Dize Biçimi
Yükleme için olası dize biçimlerinin listesi.
İmza:
export declare type StringFormat = (typeof StringFormat)[keyof typeof StringFormat];
Görev Etkinliği
Bir görevde tetiklenen etkinlik.
İmza:
export declare type TaskEvent = 'state_changed';
Görev Durumu
Çalışmakta olan bir yüklemenin mevcut durumunu temsil eder.
İmza:
export declare type TaskState = 'running' | 'paused' | 'success' | 'canceled' | 'error';
Depolama Hata Kodu
StorageError
nesneye eklenebilecek hata kodları.
İmza:
export declare enum StorageErrorCode
Numaralandırma Üyeleri
Üye | Değer | Açıklama |
---|---|---|
UYGULAMA_SİLİNDİ | "app-deleted" |
|
BUCKET_NOT_FOUND | "bucket-not-found" |
|
İPTAL EDİLDİ | "canceled" |
|
CANNOT TRANSLATE | "cannot-slice-blob" |
|
DAHİLİ_HATA | "internal-error" |
|
GEÇERSİZ_BAĞ_DEĞİŞKEN | "invalid-argument" |
|
GEÇERSİZ_BAĞ_BAĞ_DEĞ_SAY | "invalid-argument-count" |
|
GEÇERSİZ_DEĞERLENDİRME | "invalid-checksum" |
|
GEÇERSİZ_VARSAYILAN_PAKET | "invalid-default-bucket" |
|
GEÇERSİZ_ETKİNLİK_ADI | "invalid-event-name" |
|
GEÇERSİZ_BİÇİM | "invalid-format" |
|
GEÇERSİZ_ROOT_ÇALIŞMASI | "invalid-root-operation" |
|
GEÇERSİZ_URL | "invalid-url" |
|
VARSAYILAN_PAKET_YOK | "no-default-bucket" |
|
YOK_İNDİRME_URL'Sİ | "no-download-url" |
|
OBJECT_NOT_FOUND | "object-not-found" |
|
PROJE_DEĞİL_BULUNDUR | "project-not-found" |
|
QUOTA_EXCEEDED | "quota-exceeded" |
|
RETRY_LIMIT_EXCEEDED | "retry-limit-exceeded" |
|
SUNUCU_FILE_WRONG_BOYUT | "server-file-wrong-size" |
|
KİMLİK DOĞRULAMADI | "unauthenticated" |
|
YETKİSİZ | "unauthorized" |
|
YETKİSİZ_UYGULAMA | "unauthorized-app" |
|
BİLİNMİYOR | "unknown" |
|
UNSUPPORTED_ENVIRONMENT | "unsupported-environment" |