storage package

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

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:

StorageReference

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:

UploadTask

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:

StorageReference

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"