chrome.syncFileSystem

Açıklama

Google Drive'da veri kaydetmek ve senkronize etmek için chrome.syncFileSystem API'yi kullanın. Bu API, Google Drive'da depolanan rastgele kullanıcı dokümanlarına erişmek için DEĞİLDİR. Çevrimdışı ve önbelleğe alma kullanımı için uygulamaya özel senkronize edilebilir depolama alanı sağlar. Böylece, aynı veriler farklı istemcilerde kullanılabilir. Bu API'yi kullanma hakkında daha fazla bilgi için Verileri Yönetme başlıklı makaleyi okuyun.

İzinler

syncFileSystem

Türler

ConflictResolutionPolicy

Enum

"last_write_win"

"manual"

FileInfo

Özellikler

  • işlem

    SyncAction isteğe bağlı

    onFileStatusChanged etkinliğini tetiklemek için senkronizasyon işlemi yapıldı. İşlem değeri 'added', 'updated' veya 'deleted' olabilir. Yalnızca durum 'synced' olduğunda geçerlidir.

  • direction

    SyncDirection isteğe bağlı

    onFileStatusChanged etkinliği için yol tarifini senkronize edin. Senkronizasyon yönü değeri 'local_to_remote' veya 'remote_to_local' olabilir. Yalnızca durum 'synced' olduğunda geçerlidir.

  • fileEntry

    Giriş

    Durumu değişen hedef dosya için fileEntry. Senkronize edilmiş dosyanın adını ve yol bilgilerini içerir. Dosya silme işleminden sonra fileEntry bilgileri kullanılabilir olmaya devam eder ancak dosya artık mevcut olmaz.

  • durum

    FileStatus

    onFileStatusChanged etkinliğinden sonra ortaya çıkan dosya durumu. Durum değeri 'synced', 'pending' veya 'conflicting' olabilir.

FileStatus

Enum

"synced"
Çakışan değil ve bekleyen yerel değişikliği yok.

"pending"
Senkronize edilmemiş bir veya daha fazla beklemede yerel değişikliği var.

"conflicting"
Dosya, uzak sürümle çakışıyor ve manuel olarak çözülmesi gerekiyor.

FileStatusInfo

Özellikler

  • hata

    dize isteğe bağlı

    Yalnızca ilgili dosyanın FileStatus (Dosya Durumu) alınırken bir sorun oluştuğunda döndürülen isteğe bağlı hata.

  • fileEntry

    Giriş

    İlk olarak getFileStatuses'a bir giriş verilmiştir.

  • durum

    FileStatus

    Durum değeri 'synced', 'pending' veya 'conflicting' olabilir.

ServiceInfo

Özellikler

ServiceStatus

Enum

"Başlatılıyor"
Senkronizasyon hizmeti başlatılıyor (ör. verileri veritabanından geri yükleme, bağlantıyı kontrol etme ve hizmet için kimlik doğrulaması yapma).

" running"
Senkronizasyon hizmeti etkin ve çalışır durumdadır.

"authentication_required"
Uzak hizmetin devam edebilmesi için kullanıcı kimliğinin doğrulanması gerektiğinden senkronizasyon hizmeti dosyaları senkronize etmiyor.

"temporary_unavailable"
Uzak hizmet, bazı kurtarılabilir hatalardan dolayı (geçici olarak) kullanılamadığından senkronizasyon hizmeti dosyaları senkronize etmiyor. Örneğin, ağ çevrimdışı, uzak hizmet kapalı veya erişilemez vb. OnServiceInfoUpdated sayfasındaki description parametresiyle (hizmete özgü ayrıntılar içerebilir) daha fazla ayrıntı verilmelidir.

" disabled"
Senkronizasyon hizmeti devre dışıdır ve içerik hiçbir zaman senkronize edilmeyecektir. (Örneğin, kullanıcının uzak hizmette hesabı yoksa veya senkronizasyon hizmetinde düzeltilemeyen bir hata oluştuysa bu durum ortaya çıkabilir.)

StorageInfo

Özellikler

  • quotaBytes

    sayı

  • usageBytes

    sayı

SyncAction

Enum

"eklendi"

"güncellendi"

"silindi"

SyncDirection

Enum

"local_to_remote"

"remote_to_local"

Yöntemler

getConflictResolutionPolicy()

Söz 'nı inceleyin.
chrome.syncFileSystem.getConflictResolutionPolicy(
  callback?: function,
)

Geçerli anlaşmazlık çözümü politikasını alır.

Parametreler

İadeler

  • Promise<ConflictResolutionPolicy>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getFileStatus()

Söz 'nı inceleyin.
chrome.syncFileSystem.getFileStatus(
  fileEntry: Entry,
  callback?: function,
)

Belirtilen fileEntry için FileStatus değerini döndürür. Durum değeri 'synced', 'pending' veya 'conflicting' olabilir. 'conflicting' durumunun yalnızca hizmetin çakışma çözümü politikası 'manual' olarak ayarlandığında geçerli olduğunu unutmayın.

Parametreler

  • fileEntry

    Giriş

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (status: FileStatus) => void

İadeler

  • Promise<FileStatus>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getFileStatuses()

Söz 'nı inceleyin.
chrome.syncFileSystem.getFileStatuses(
  fileEntries: object[],
  callback?: function,
)

Belirli bir fileEntry dizisi için her bir FileStatus değerini döndürür. Genellikle dirReader.readEntries() sonucuyla çağrılır.

Parametreler

  • fileEntries

    object[]

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (status: FileStatusInfo[]) => void

İadeler

  • Promise<FileStatusInfo[]>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getServiceStatus()

Söz 'nı inceleyin.
chrome.syncFileSystem.getServiceStatus(
  callback?: function,
)

Mevcut senkronizasyon arka uç durumunu döndürür.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (status: ServiceStatus) => void

İadeler

  • Promise<ServiceStatus>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getUsageAndQuota()

Söz 'nı inceleyin.
chrome.syncFileSystem.getUsageAndQuota(
  fileSystem: DOMFileSystem,
  callback?: function,
)

Uygulamanın 'syncable' dosya depolama alanı için mevcut kullanımı ve kotayı bayt cinsinden döndürür.

Parametreler

  • fileSystem

    DOMFileSystem

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (info: StorageInfo) => void

İadeler

  • Promise<StorageInfo>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

requestFileSystem()

Söz 'nı inceleyin.
chrome.syncFileSystem.requestFileSystem(
  callback?: function,
)

Google Drive tarafından desteklenen senkronize edilebilir bir dosya sistemini döndürür. Döndürülen DOMFileSystem örneği, Geçici ve Kalıcı dosya sistemleriyle aynı şekilde çalıştırılabilir (bkz. http://dev.w3.org/2009/dap/file-system/file-dir-sys.html).

Bu herkese açık kullanıcı adı, aynı uygulamadan birden fazla kez çağrıldığında aynı herkese açık kullanıcı adı aynı dosya sistemine döndürülür.

Bu aramanın başarısız olabileceğini unutmayın. Örneğin, kullanıcı Chrome'da oturum açmamışsa veya ağ işlemi yoksa. Bu hataları işlemek için geri çağırmada chrome.runtime.lastError öğesinin kontrol edilmesi önemlidir.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (fileSystem: DOMFileSystem) => void

    • fileSystem

      DOMFileSystem

İadeler

  • Promise<DOMFileSystem>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

setConflictResolutionPolicy()

Söz 'nı inceleyin.
chrome.syncFileSystem.setConflictResolutionPolicy(
  policy: ConflictResolutionPolicy,
  callback?: function,
)

Uygulamanın 'syncable' dosya depolamasına ilişkin varsayılan çakışma çözümü politikasını ayarlar. Varsayılan olarak 'last_write_win' değerine ayarlıdır. Çakışma çözümleme politikası 'last_write_win' olarak ayarlandığında, mevcut dosyalar için çakışmalar dosya tekrar güncellendiğinde otomatik olarak çözülür. İsteğin başarılı olup olmadığını öğrenmek için isteğe bağlı olarak callback verilebilir.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Taahhüt<void>

    Chrome 117 ve sonraki sürümler 'nı inceleyin.

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

Etkinlikler

onFileStatusChanged

chrome.syncFileSystem.onFileStatusChanged.addListener(
  callback: function,
)

Bir dosya, arka plan senkronizasyon hizmeti tarafından güncellendiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (detail: FileInfo) => void

onServiceStatusChanged

chrome.syncFileSystem.onServiceStatusChanged.addListener(
  callback: function,
)

Senkronizasyon arka ucunda bir hata veya başka bir durum değişikliği olduğunda (örneğin, ağ veya kimlik doğrulama hatası nedeniyle senkronizasyon geçici olarak devre dışı bırakıldığında) tetiklenir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (detail: ServiceInfo) => void