chrome.fileSystemProvider

Açıklama

Chrome OS'teki dosya yöneticisinden erişilebilen dosya sistemleri oluşturmak için chrome.fileSystemProvider API'yi kullanın.

İzinler

fileSystemProvider

Kullanılabildiği yerler

Yalnızca ChromeOS

File System Provider API'yi kullanmak için uzantı manifestinde "fileSystemProvider" iznini ve bölümünü beyan etmeniz gerekir. Örneğin:

{
  "name": "My extension",
  ...
  "permissions": [
    "fileSystemProvider"
  ],
  ...
  "file_system_provider_capabilities": {
    "configurable": true,
    "watchable": false,
    "multiple_mounts": true,
    "source": "network"
  },
  ...
}

file_system_provider bölümü aşağıdaki gibi tanımlanmalıdır:

configurable (boole) - isteğe bağlı
onConfigureRequested üzerinden yapılandırmanın desteklenip desteklenmediğini belirler. Varsayılan olarak: false.
multiple_mounts (boole) - isteğe bağlı
Birden fazla (birden fazla) eklenmiş dosya sisteminin desteklenip desteklenmediği. Varsayılan olarak: false.
watchable (boole) - isteğe bağlı
İzleyicileri ayarlama ve değişiklikler hakkında bilgilendirme özelliğinin desteklenip desteklenmediği. Varsayılan olarak: false.
source ("dosya", "cihaz" veya "ağ" sıralaması) - gerekli
Eklenmiş dosya sistemleri için verilerin kaynağı.

Files uygulaması, ilgili kullanıcı arayüzü öğelerini uygun şekilde oluşturmak için yukarıdaki bilgileri kullanır. Örneğin, configurable politikası doğru değerine ayarlanırsa birimleri yapılandırmak için bir menü öğesi oluşturulur. Benzer şekilde, multiple_mounts true olarak ayarlanırsa Files uygulaması, kullanıcı arayüzünden birden fazla ekleme noktası eklemeye izin verir. watchable değeri false ise yenile düğmesi oluşturulur. Dosya sistemindeki değişikliklerin anında ve otomatik olarak yansıtılması için mümkünse izleyiciler için destek eklemeniz gerektiğini unutmayın.

Genel bakış

File System Provider API, uzantıların ChromeOS'teki dosya yöneticisinde bulunan sanal dosya sistemlerini desteklemesine olanak tanır. Sıkıştırılmış arşivleri açma ve Drive dışında bir bulut hizmetindeki dosyalara erişme, kullanım alanları arasındadır.

Dosya sistemlerini bağlama

Uzantılar, harici bir kaynaktan (uzak sunucu veya USB cihazı gibi) dosya sistemi içeriklerini sağlayabilir veya giriş olarak yerel bir dosya (ör. arşiv) kullanabilir.

onLaunched etkinliği uzantılar tarafından kullanılamadığından, dosya işleyici olan (kaynak "file") dosya sistemlerini yazmak için sağlayıcının paket uygulama olması gerekir.

Kaynak ağ veya bir cihaz ise onMountRequested etkinliği çağrıldığında dosya sistemi eklenmelidir.

Dosya sistemi verilerinin kaynağı Giriş noktası
"file" Yalnızca paket uygulamalar tarafından kullanılabilir.
"device" veya "network" onMountRequested

Dosya sistemlerini yapılandırma

Sağlanan dosya sistemleri, eklendikten sonra onConfigureRequested etkinliği aracılığıyla yapılandırılabilir. Bu, özellikle doğru kimlik bilgilerini ayarlamak üzere içeriği ağ üzerinden sağlayan dosya sistemleri için kullanışlıdır. Bu etkinliğin işlenmesi isteğe bağlıdır.

Yaşam döngüsü

Sağlanan dosya sistemleri, eklendikten sonra Chrome tarafından hatırlanır ve yeniden başlatıldıktan veya yeniden başlatıldıktan sonra otomatik olarak yeniden eklenir. Dolayısıyla, bir dosya sistemi sağlanan uzantı tarafından eklendikten sonra, ya uzantı kaldırılana ya da uzantı unmount yöntemini çağırana kadar kalır.

Türler

AbortRequestedOptions

Özellikler

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • operationRequestId

    sayı

    İptal edilecek isteğin kimliği.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

Action

Chrome 45 ve sonraki sürümler

Özellikler

  • id

    dize

    İşlemin tanımlayıcısı. Sık kullanılan işlemler için herhangi bir dize veya CommonActionId.

  • title

    string isteğe bağlı

    İşlemin başlığı. Sık kullanılan işlemler için yoksayılabilir.

AddWatcherRequestedOptions

Özellikler

  • entryPath

    dize

    Gözlemlenecek girişin yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • yinelemeli

    boolean

    Gözlemleme işleminin tüm alt girişleri yinelemeli olarak içerip içermemesi gerektiği. Yalnızca dizinler için doğru olabilir.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

Change

Özellikler

  • changeType

    ChangeType

    Girişte yapılan değişikliğin türü.

  • cloudFileInfo

    CloudFileInfo isteğe bağlı

    Beklemede

    Bulut dosya sistemi tarafından destekleniyorsa dosyayla ilgili bilgiler.

  • entryPath

    dize

    Değiştirilen girişin yolu.

ChangeType

Gözlemlenen dizinde algılanan değişikliğin türü.

Enum

CloseFileRequestedOptions

Özellikler

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • openRequestId

    sayı

    Dosyayı açmak için kullanılan istek kimliği.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

CloudFileInfo

Beklemede

Özellikler

  • versionTag

    string isteğe bağlı

    Dosyanın sürümünü temsil eden bir etiket.

CloudIdentifier

Chrome 117 ve sonraki sürümler

Özellikler

  • id

    dize

    Belirtilen dosya/dizin için sağlayıcının tanımlayıcısı.

  • providerName

    dize

    Bulut depolama alanı sağlayıcısının tanımlayıcısı (ör. "drive.google.com").

CommonActionId

Chrome 45 ve sonraki sürümler

Sık kullanılan işlemlerin listesi. "SHARE", başkalarıyla dosya paylaşmak içindir. Sabitleme için "SAVE_FOR_OFFLINE" (çevrimdışı erişim için kaydedilir). Dosyanın artık çevrimdışı erişim için depolanmasına gerek olmadığını bildirmek için "OFFLINE_NOT_NECESSARY". onGetActionsRequested ve onExecuteActionRequested tarafından kullanılır.

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

ConfigureRequestedOptions

Chrome 44 ve sonraki sürümler

Özellikler

  • fileSystemId

    dize

    Yapılandırılacak dosya sisteminin tanımlayıcısı.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

CopyEntryRequestedOptions

Özellikler

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

  • sourcePath

    dize

    Kopyalanacak girişin kaynak yolu.

  • targetPath

    dize

    Kopyalama işleminin hedef yolu.

CreateDirectoryRequestedOptions

Özellikler

  • directoryPath

    dize

    Oluşturulacak dizinin yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • yinelemeli

    boolean

    İşlemin yinelemeli olup olmadığı (yalnızca dizinler için).

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

CreateFileRequestedOptions

Özellikler

  • filePath

    dize

    Oluşturulacak dosyanın yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

DeleteEntryRequestedOptions

Özellikler

  • entryPath

    dize

    Silinecek girişin yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • yinelemeli

    boolean

    İşlemin yinelemeli olup olmadığı (yalnızca dizinler için).

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

EntryMetadata

Özellikler

  • cloudFileInfo

    CloudFileInfo isteğe bağlı

    Beklemede

    Temel bulut dosya sisteminde belirli bir dosyayı tanımlayan bilgiler. options içinde istenirse ve dosya bulut depolama alanı tarafından destekleniyorsa sağlanmalıdır.

  • cloudIdentifier

    CloudIdentifier isteğe bağlı

    Chrome 117 ve sonraki sürümler

    Bu girişin Cloud Storage temsili. options içinde istenirse ve dosya bulut depolama alanı tarafından destekleniyorsa sağlanmalıdır. Bulut depolama alanı tarafından desteklenmeyen yerel dosyalar istendiğinde tanımlanmamış olmalıdır.

  • isDirectory

    boole isteğe bağlı

    Bu bir dizinse doğru değerini alır. options içinde istenirse sağlanmalıdır.

  • mimeType

    string isteğe bağlı

    Girişin MIME türü. Her zaman isteğe bağlıdır, ancak options içinde istenirse sağlanmalıdır.

  • modificationTime

    Tarih isteğe bağlı

    Bu girişin son değiştirilme zamanı. options içinde istenirse sağlanmalıdır.

  • ad

    string isteğe bağlı

    Bu girişin adı (tam yol adı değil). "/" içermemelidir. Kök için alan boş olmalıdır. options içinde istenirse sağlanmalıdır.

  • beden

    numara isteğe bağlı

    Bayt cinsinden dosya boyutu. options içinde istenirse sağlanmalıdır.

  • küçük resim

    string isteğe bağlı

    Veri URI'si biçiminde, PNG, JPEG veya WEBP biçiminde, en fazla 32 KB boyutunda küçük resim. İsteğe bağlıdır, ancak yalnızca onGetMetadataRequested etkinliği tarafından açıkça istendiğinde sağlanabilir.

ExecuteActionRequestedOptions

Chrome 45 ve sonraki sürümler

Özellikler

  • actionId

    dize

    Yürütülecek işlemin tanımlayıcısı.

  • entryPaths

    dize[]

    Chrome 47 ve sonraki sürümler

    İşlem için kullanılacak girişlerin yolları grubu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

FileSystemInfo

Özellikler

  • displayName

    dize

    Dosya sistemi için kullanıcıların okuyabileceği bir ad.

  • fileSystemId

    dize

    Dosya sisteminin tanımlayıcısı.

  • openedFiles

    OpenedFile[]

    Açık olan dosyaların listesi.

  • openedFilesLimit

    sayı

    Tek seferde açılabilen maksimum dosya sayısı. 0 ise sınırlı değildir.

  • supportsNotifyTag

    boole isteğe bağlı

    Chrome 45 ve sonraki sürümler

    Dosya sisteminin, dizinleri gözlemlemek için tag alanını destekleyip desteklemediği.

  • izleyiciler

    İzleyici[]

    Chrome 45 ve sonraki sürümler

    İzleyicilerin listesi.

  • yazılabilir

    boolean

    Dosya sisteminin, dosya sisteminin içeriğini değiştirebilecek işlemleri (ör. dosya oluşturma, silme veya dosyalara yazma) destekleyip desteklemediği.

GetActionsRequestedOptions

Chrome 45 ve sonraki sürümler

Özellikler

  • entryPaths

    dize[]

    Chrome 47 ve sonraki sürümler

    İşlem listesi giriş yollarının listesi.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

GetMetadataRequestedOptions

Özellikler

  • cloudFileInfo

    boolean

    Beklemede

    cloudFileInfo değeri istenirse true olarak ayarlayın.

  • cloudIdentifier

    boolean

    Chrome 117 ve sonraki sürümler

    cloudIdentifier değeri istenirse true olarak ayarlayın.

  • entryPath

    dize

    İlgili meta verilerin getirileceği girişin yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • isDirectory

    boolean

    Chrome 49 ve sonraki sürümler

    is_directory değeri istenirse true olarak ayarlayın.

  • mimeType

    boolean

    Chrome 49 ve sonraki sürümler

    mimeType değeri istenirse true olarak ayarlayın.

  • modificationTime

    boolean

    Chrome 49 ve sonraki sürümler

    modificationTime değeri istenirse true olarak ayarlayın.

  • ad

    boolean

    Chrome 49 ve sonraki sürümler

    name değeri istenirse true olarak ayarlayın.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

  • beden

    boolean

    Chrome 49 ve sonraki sürümler

    size değeri istenirse true olarak ayarlayın.

  • küçük resim

    boolean

    thumbnail değeri istenirse true olarak ayarlayın.

MountOptions

Özellikler

  • displayName

    dize

    Dosya sistemi için kullanıcıların okuyabileceği bir ad.

  • fileSystemId

    dize

    Dosya sisteminin dize tanımlayıcısı. Her uzantı için benzersiz olmalıdır.

  • openedFilesLimit

    numara isteğe bağlı

    Tek seferde açılabilen maksimum dosya sayısı. Belirtilmezse veya 0 ise sınırlı değildir.

  • inatçı

    boole isteğe bağlı

    Chrome 64 ve sonraki sürümler

    Çerçevenin bir sonraki oturum açma oturumunda dosya sistemini devam ettirip sürdürmeyeceği. True olarak ayarlayın.

  • supportsNotifyTag

    boole isteğe bağlı

    Chrome 45 ve sonraki sürümler

    Dosya sisteminin, gözlemlenen dizinler için tag alanını destekleyip desteklemediği.

  • yazılabilir

    boole isteğe bağlı

    Dosya sisteminin, dosya sisteminin içeriğini değiştirebilecek işlemleri (ör. dosya oluşturma, silme veya dosyalara yazma) destekleyip desteklemediği.

MoveEntryRequestedOptions

Özellikler

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

  • sourcePath

    dize

    Yeni bir yere taşınacak girişin kaynak yolu.

  • targetPath

    dize

    Kopyalama işleminin hedef yolu.

NotifyOptions

Özellikler

  • changeType

    ChangeType

    Gözlemlenen girişte gerçekleşen değişikliğin türü. SİLİNDİ ise gözlemlenen giriş, gözlemlenen girişler listesinden otomatik olarak kaldırılır.

  • değişiklikler

    Değiştirin[] isteğe bağlı

    Gözlemlenen dizindeki girişlerde yapılan değişikliklerin listesi (girişin kendisi dahil)

  • fileSystemId

    dize

    Bu değişiklikle ilgili dosya sisteminin tanımlayıcısı.

  • observedPath

    dize

    Gözlemlenen girişin yolu.

  • yinelemeli

    boolean

    Gözlemlenen girişin modu.

  • etiket

    string isteğe bağlı

    Bildirim için etiket. Dosya sistemi supportsNotifyTag seçeneğiyle eklenmişse gereklidir. Bu işaretin, sistem kapatıldığında bile değişen değişikliklerle ilgili bildirimler sağlamak için gerekli olduğunu unutmayın.

OpenedFile

Özellikler

  • filePath

    dize

    Açılan dosyanın yolu.

  • Dosyanın okuma mı yoksa yazma için mi açıldığı.

  • openRequestId

    sayı

    Birbirini izleyen okuma/yazma ve kapatma istekleri tarafından kullanılacak istek kimliği.

OpenFileMode

Dosya açma modu. onOpenFileRequested tarafından kullanılıyor.

Enum

"READ"

OpenFileRequestedOptions

Özellikler

  • filePath

    dize

    Açılacak dosyanın yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • Dosyanın okuma mı yoksa yazma için mi kullanılacağı.

  • requestId

    sayı

    Birbirini izleyen okuma/yazma ve kapatma istekleri tarafından kullanılacak istek kimliği.

ProviderError

İsteklere yanıt olarak uzantı sağlayarak ve API'nin yöntemleri çağrılırken hata oluşması durumunda kullanılan hata kodları. Başarı için "OK" kullanılmalıdır.

Enum

"IN_USE":

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

ReadDirectoryRequestedOptions

Özellikler

  • directoryPath

    dize

    İçeriğin istendiği dizin yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • isDirectory

    boolean

    Chrome 49 ve sonraki sürümler

    is_directory değeri istenirse true olarak ayarlayın.

  • mimeType

    boolean

    Chrome 49 ve sonraki sürümler

    mimeType değeri istenirse true olarak ayarlayın.

  • modificationTime

    boolean

    Chrome 49 ve sonraki sürümler

    modificationTime değeri istenirse true olarak ayarlayın.

  • ad

    boolean

    Chrome 49 ve sonraki sürümler

    name değeri istenirse true olarak ayarlayın.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

  • beden

    boolean

    Chrome 49 ve sonraki sürümler

    size değeri istenirse true olarak ayarlayın.

  • küçük resim

    boolean

    Chrome 49 ve sonraki sürümler

    thumbnail değeri istenirse true olarak ayarlayın.

ReadFileRequestedOptions

Özellikler

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • length

    sayı

    Döndürülecek bayt sayısı.

  • ofset

    sayı

    Okumaya başlanacak dosyadaki konum (bayt cinsinden).

  • openRequestId

    sayı

    Dosyayı açmak için kullanılan istek kimliği.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

RemoveWatcherRequestedOptions

Özellikler

  • entryPath

    dize

    İzlenen girişin yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • yinelemeli

    boolean

    İzleyicinin modu.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

TruncateRequestedOptions

Özellikler

  • filePath

    dize

    Kısaltılacak dosyanın yolu.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • length

    sayı

    İşlem tamamlandıktan sonra korunacak bayt sayısı.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

UnmountOptions

Özellikler

  • fileSystemId

    dize

    Bağlantısı kesilecek dosya sisteminin tanımlayıcısı.

UnmountRequestedOptions

Özellikler

  • fileSystemId

    dize

    Bağlantısı kesilecek dosya sisteminin tanımlayıcısı.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

Watcher

Özellikler

  • entryPath

    dize

    Gözlemlenen girişin yolu.

  • lastTag

    string isteğe bağlı

    İzleyici için son bildirimde kullanılan etiket.

  • yinelemeli

    boolean

    İzleme işleminin, tüm alt girişleri yinelemeli olarak içerip içermeyeceğini belirleme. Yalnızca dizinler için doğru olabilir.

WriteFileRequestedOptions

Özellikler

  • veri

    ArrayBuffer

    Dosyaya yazılacak bayt arabelleği.

  • fileSystemId

    dize

    Bu işlemle ilgili dosya sisteminin tanımlayıcısı.

  • ofset

    sayı

    Baytların yazılmasına başlanacak dosyadaki konum (bayt cinsinden).

  • openRequestId

    sayı

    Dosyayı açmak için kullanılan istek kimliği.

  • requestId

    sayı

    Bu isteğin benzersiz tanımlayıcısıdır.

Yöntemler

get()

Söz 
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
)

Geçirilen fileSystemId özelliğine sahip bir dosya sistemi hakkında bilgi döndürür.

Parametreler

  • fileSystemId

    dize

  • geri çağırma

    Functions (isteğe bağlı)

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

    (fileSystem: FileSystemInfo)=>void

İlerlemeler

  • Promise<FileSystemInfo>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getAll()

Söz 
chrome.fileSystemProvider.getAll(
  callback?: function,
)

Uzantı tarafından eklenen tüm dosya sistemlerini döndürür.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

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

    (fileSystems: FileSystemInfo[])=>void

İlerlemeler

  • Promise<FileSystemInfo[]>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

mount()

Söz 
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
)

Belirtilen fileSystemId ve displayName değerlerine sahip bir dosya sistemi ekler. displayName, Dosyalar uygulamasının sol panelinde gösterilir. displayName, "/" dahil tüm karakterleri içerebilir, ancak boş dize olamaz. displayName açıklayıcı olmalıdır, ancak benzersiz olması gerekmez. fileSystemId boş bir dize olmamalıdır.

Eklenen dosya sisteminin türüne bağlı olarak source seçeneği uygun şekilde ayarlanmalıdır.

Hata olması durumunda runtime.lastError ilgili hata koduyla ayarlanır.

Parametreler

  • seçenekler

    MountOptions

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

notify()

Söz Chrome 45 ve sonraki sürümler 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
)

recursive modunda observedPath konumundaki izlenen dizinde yapılan değişiklikler hakkında bilgi verir. Dosya sistemi supportsNotifyTag ile eklendiyse tag sağlanmalı ve son bildirimden bu yana yapılan tüm değişiklikler, sistem kapatılmış olsa bile her zaman bildirilmelidir. Son etiket getAll ile alınabilir.

Kullanmak için file_system_provider.notify manifest seçeneğinin doğru değerine ayarlanması gerekir.

tag değeri, her çağrı için benzersiz olan herhangi bir dize olabilir. Bu nedenle, son kaydedilen bildirim tespit edilebilir. Örneğin, sağlanan uzantı yeniden başlatma sonrasında başlıyorsa ve kaydedilen son bildirimin etiketi "123"e eşitse "123" olarak etiketlenen değişiklikten bu yana gerçekleşen tüm değişiklikler için notify yöntemini çağırması gerekir. Boş dize olamaz.

Tüm sağlayıcılar etiket sağlayamaz ancak dosya sisteminde değişiklik günlüğü varsa etiket, değişiklik numarası veya düzeltme numarası olabilir.

Bir üst dizin kaldırılırsa tüm alt girişler de kaldırılır. Bu girişler izlenirse API'ye konuyla ilgili bilgi verilmesi gerektiğini unutmayın. Ayrıca, bir dizin yeniden adlandırılırsa artık orijinal yolları altında herhangi bir giriş olmayacağından tüm alt girişler kaldırılır.

Hata olması durumunda runtime.lastError yerine ilgili hata kodu ayarlanır.

Parametreler

  • seçenekler

    NotifyOptions

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

unmount()

Söz 
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
)

Belirtilen fileSystemId değerine sahip bir dosya sisteminin bağlantısını keser. Parametre, onUnmountRequested çağrıldıktan sonra çağrılmalıdır. Ayrıca, sağlanan uzantı, istenmediği takdirde (ör. bağlantı kopması veya dosya hatası durumunda) bağlantıyı kesmeye karar verebilir.

Hata olması durumunda runtime.lastError ilgili hata koduyla ayarlanır.

Parametreler

  • seçenekler

    UnmountOptions

  • geri çağırma

    Functions (isteğe bağlı)

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

    ()=>void

İlerlemeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onAbortRequested

chrome.fileSystemProvider.onAbortRequested.addListener(
  callback: function,
)

operationRequestId ile bir işlemi iptal etme isteğinde bulunulduğunda belirlenir. operationRequestId ile yürütülen işlem hemen durdurulmalı ve bu iptal isteğinin successCallback kadarı yürütülmelidir. İptal işlemi başarısız olursa errorCallback çağrılmalıdır. İptal edilen işlemle ilgili geri çağırma işlevleri, yoksayılacağı için çağrılmamalıdır. errorCallback aranmasına rağmen istek zorla iptal edilebilir.

Parametreler

  • geri çağırma

    işlev

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

    (options: AbortRequestedOptions,successCallback: function,errorCallback: function)=>void

    • seçenekler

      AbortRequestedOptions

    • successCallback

      işlev

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

      ()=>void

    • errorCallback

      işlev

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

      (error: ProviderError)=>void

onAddWatcherRequested

Chrome 45 ve sonraki sürümler 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Yeni bir dizin izleyicisi ayarlanması istendiğinde yükseltilir. Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (options: AddWatcherRequestedOptions,successCallback: function,errorCallback: function)=>void

onCloseFileRequested

chrome.fileSystemProvider.onCloseFileRequested.addListener(
  callback: function,
)

Daha önce openRequestId ile açılmış bir dosyayı açmanın kapatılması istendiğinde yükseltilen.

Parametreler

  • geri çağırma

    işlev

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

    (options: CloseFileRequestedOptions,successCallback: function,errorCallback: function)=>void

onConfigureRequested

Chrome 44 ve sonraki sürümler 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

fileSystemId için yapılandırma iletişim kutusu gösterildiğinde yükseltilir. İşlenirse file_system_provider.configurable manifest seçeneği true olarak ayarlanmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (options: ConfigureRequestedOptions,successCallback: function,errorCallback: function)=>void

onCopyEntryRequested

chrome.fileSystemProvider.onCopyEntryRequested.addListener(
  callback: function,
)

Bir giriş kopyalanırken gösterilir (bir dizinse yinelenen olarak). Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (options: CopyEntryRequestedOptions,successCallback: function,errorCallback: function)=>void

onCreateDirectoryRequested

chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
  callback: function,
)

Dizin oluşturma istendiğinde yükseltilir. Hedef dizin zaten mevcutsa işlem EXISTS hatasıyla başarısız olmalıdır. recursive değeri true ise dizin yolundaki eksik tüm dizinlerin oluşturulması gerekir.

Parametreler

onCreateFileRequested

chrome.fileSystemProvider.onCreateFileRequested.addListener(
  callback: function,
)

Dosya oluşturma istendiğinde yükseltilir. Dosya zaten mevcutsa errorCallback, "EXISTS" hata koduyla çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (options: CreateFileRequestedOptions,successCallback: function,errorCallback: function)=>void

onDeleteEntryRequested

chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
  callback: function,
)

Bir giriş silinmesi istendiğinde gösterilir. recursive true (doğru) değerine ayarlanırsa ve giriş bir dizinse, içerideki tüm girişlerin de yinelemeli olarak silinmesi gerekir.

Parametreler

  • geri çağırma

    işlev

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

    (options: DeleteEntryRequestedOptions,successCallback: function,errorCallback: function)=>void

onExecuteActionRequested

Chrome 48 ve sonraki sürümler 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Bir dosya veya dizin grubu için işlem yürütülürken oluşturulan uyarı. İşlem tamamlandıktan sonra successCallback çağrılmalıdır. Hata durumunda errorCallback çağrılmalıdır.

Parametreler

onGetActionsRequested

Chrome 48 ve sonraki sürümler 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

entryPaths alanındaki bir dosya veya dizin grubu için işlem listesi istendiğinde yükseltilir. Döndürülen tüm işlemler her bir giriş için geçerli olmalıdır. Bu tür bir işlem yoksa boş bir dizi döndürülmelidir. İşlemler successCallback çağrısıyla döndürülmelidir. Hata olması durumunda errorCallback çağrılmalıdır.

Parametreler

onGetMetadataRequested

chrome.fileSystemProvider.onGetMetadataRequested.addListener(
  callback: function,
)

entryPath adresindeki bir dosyanın veya dizinin meta verileri istendiğinde yükseltilir. Meta veriler successCallback çağrısıyla döndürülmelidir. Hata olması durumunda errorCallback çağrılmalıdır.

Parametreler

onMountRequested

Chrome 44 ve sonraki sürümler 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Yeni bir dosya sistemi eklemek için iletişim kutusu gösterildiğinde yükseltilir. Uzantı/uygulama bir dosya işleyiciyse bu etkinlik işlenmemelidir. Bunun yerine, bir dosya açıldığında yeni dosya sistemleri eklemek için app.runtime.onLaunched işlenmelidir. Birden fazla ekleme için file_system_provider.multiple_mounts manifest seçeneği true olarak ayarlanmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (successCallback: function,errorCallback: function)=>void

    • successCallback

      işlev

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

      ()=>void

    • errorCallback

      işlev

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

      (error: ProviderError)=>void

onMoveEntryRequested

chrome.fileSystemProvider.onMoveEntryRequested.addListener(
  callback: function,
)

Bir giriş taşınırken yükseltilir (bir dizinse yinelemeli). Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (options: MoveEntryRequestedOptions,successCallback: function,errorCallback: function)=>void

onOpenFileRequested

chrome.fileSystemProvider.onOpenFileRequested.addListener(
  callback: function,
)

filePath konumunda bir dosya açılması istendiğinde yükseltilir. Dosya mevcut değilse işlem başarısız olmalıdır. Aynı anda açılan maksimum dosya sayısı MountOptions ile belirtilebilir.

Parametreler

onReadDirectoryRequested

chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
  callback: function,
)

directoryPath adresindeki bir dizinin içeriği istendiğinde yükseltilir. successCallback birkaç kez çağrılarak sonuçların parçalar halinde döndürülmesi gerekir. Hata olması durumunda errorCallback çağrılmalıdır.

Parametreler

onReadFileRequested

chrome.fileSystemProvider.onReadFileRequested.addListener(
  callback: function,
)

Daha önce openRequestId ile açılmış bir dosyanın içeriği okunması istendiğinde yükseltilecek. Sonuçların, successCallback birkaç kez çağrılmasıyla parçalar halinde döndürülmesi gerekir. Hata olması durumunda errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (options: ReadFileRequestedOptions,successCallback: function,errorCallback: function)=>void

    • successCallback

      işlev

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

      (data: ArrayBuffer,hasMore: boolean)=>void

      • veri

        ArrayBuffer

      • hasMore

        boolean

    • errorCallback

      işlev

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

      (error: ProviderError)=>void

onRemoveWatcherRequested

Chrome 45 ve sonraki sürümler 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

İzleyicinin kaldırılması gerektiğinde yükseltilmiş. Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

onTruncateRequested

chrome.fileSystemProvider.onTruncateRequested.addListener(
  callback: function,
)

Dosya, istenilen uzunlukta kısaltılırken yükseltilir. Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (options: TruncateRequestedOptions,successCallback: function,errorCallback: function)=>void

onUnmountRequested

chrome.fileSystemProvider.onUnmountRequested.addListener(
  callback: function,
)

fileSystemId tanımlayıcısına sahip dosya sistemi için bağlantıyı keserken yükseltilir. Yanıtta unmount API yöntemi, successCallback ile birlikte çağrılmalıdır. Bağlantısı kesilemiyorsa (ör. beklemedeki bir işlem nedeniyle) errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

    (options: UnmountRequestedOptions,successCallback: function,errorCallback: function)=>void

onWriteFileRequested

chrome.fileSystemProvider.onWriteFileRequested.addListener(
  callback: function,
)

Daha önce openRequestId ile açılmış bir dosyaya içerik yazılması istendiğinde yükseltilecek.

Parametreler

  • geri çağırma

    işlev

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

    (options: WriteFileRequestedOptions,successCallback: function,errorCallback: function)=>void