chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

Açıklama

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

İzinler

fileSystemProvider

Kullanılabilirlik

Yalnızca ChromeOS

Manifest

Dosya Sistemi Sağlayıcı API'sini 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 şekilde beyan edilmelidir:

configurable (boole) - isteğe bağlı
onConfigureRequested aracılığıyla yapılandırmanın desteklenip desteklenmediği. Varsayılan olarak: false.
multiple_mounts (boole) - isteğe bağlı
Birden fazla bağlı dosya sisteminin desteklenip desteklenmediği. Varsayılan olarak: false.
watchable (boole) - isteğe bağlı
İzleyicileri ayarlama ve değişiklikleri bildirme özelliklerinin desteklenip desteklenmediği. Varsayılan olarak: false.
source ("file", "device" veya "network" enum'u) - zorunlu
Bağlı dosya sistemleri için veri kaynağı.

Files uygulaması, ilgili kullanıcı arayüzü öğelerini uygun şekilde oluşturmak için yukarıdaki bilgileri kullanır. Örneğin, configurable değeri "true" olarak ayarlanırsa birimlerin yapılandırılması için bir menü öğesi oluşturulur. Benzer şekilde, multiple_mounts politikası true değerine ayarlanırsa Dosyalar uygulaması, kullanıcı arayüzünden birden fazla ekleme noktası eklenmesine izin verir. watchable, false ise yenile düğmesi gösterilir. Mümkünse izleyiciler için destek eklemeniz gerektiğini unutmayın. Böylece dosya sistemindeki değişiklikler hemen ve otomatik olarak yansıtılabilir.

Genel Bakış

File System Provider API, uzantıların ChromeOS'teki dosya yöneticisinde bulunan sanal dosya sistemlerini desteklemesine olanak tanır. Arşivleri açma ve Drive dışındaki bir bulut hizmetindeki dosyalara erişme gibi kullanım alanları vardır.

Dosya sistemlerini bağlama

Sağlayıcı uzantılar, dosya sistemi içeriklerini harici bir kaynaktan (ör. uzak sunucu veya USB cihazı) sağlayabilir ya da giriş olarak yerel bir dosya (ör. arşiv) kullanabilir.

Dosya işleyici olan dosya sistemlerini (kaynak: "file") yazmak için sağlayıcının paketlenmiş bir uygulama olması gerekir. Bunun nedeni, onLaunched etkinliğinin uzantılar tarafından kullanılamamasıdır.

Kaynak bir ağ veya cihazsa onMountRequested etkinliği çağrıldığında dosya sistemi bağlanmalıdır.

Dosya sistemi verilerinin kaynağı Giriş noktası
"file" Yalnızca paketlenmiş uygulamalarda kullanılabilir.
"device" veya "network" onMountRequested

Dosya sistemlerini yapılandırma

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

Yaşam döngüsü

Sağlanan dosya sistemleri, bağlandıktan sonra Chrome tarafından hatırlanır ve yeniden başlatma işleminden sonra otomatik olarak yeniden bağlanır. Bu nedenle, bir dosya sistemi, sağlayıcı uzantı tarafından bağlandıktan sonra uzantı kaldırılana veya 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ı.

Action

Chrome 45+

Özellikler

  • id

    dize

    İşlemin tanımlayıcısı. Herhangi bir dize veya yaygın işlemler için CommonActionId.

  • title

    string isteğe bağlı

    İşlemin başlığı. Yaygın işlemler için yok sayılabilir.

AddWatcherRequestedOptions

Özellikler

  • entryPath

    dize

    Gözlemlenecek girişin yolu.

  • fileSystemId

    dize

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

  • özyinelemeli

    boole

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

  • requestId

    sayı

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

Change

Özellikler

  • changeType

    ChangeType

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

  • cloudFileInfo

    CloudFileInfo isteğe bağlı

    Chrome 125 ve sonraki sürümler

    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şiklik türü.

Enum

"CHANGED"

"DELETED"

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ı.

CloudFileInfo

Chrome 125 ve sonraki sürümler

Ö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

    Sağlayıcının, belirli bir dosya/dizin için 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+

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

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"PAYLAŞ"

ConfigureRequestedOptions

Chrome 44+

Özellikler

  • fileSystemId

    dize

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

  • requestId

    sayı

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

CopyEntryRequestedOptions

Özellikler

  • fileSystemId

    dize

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

  • requestId

    sayı

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

  • 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ı.

  • özyinelemeli

    boole

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

  • requestId

    sayı

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

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ı.

DeleteEntryRequestedOptions

Özellikler

  • entryPath

    dize

    Silinecek girişin yolu.

  • fileSystemId

    dize

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

  • özyinelemeli

    boole

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

  • requestId

    sayı

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

EntryMetadata

Özellikler

  • cloudFileInfo

    CloudFileInfo isteğe bağlı

    Chrome 125 ve sonraki sürümler

    Temel bulut dosya sistemindeki belirli bir dosyayı tanımlayan bilgiler. options içinde isteniyorsa 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 bulut depolama alanı gösterimi. options içinde isteniyorsa ve dosya bulut depolama alanı tarafından destekleniyorsa sağlanmalıdır. Bulut depolama alanı tarafından desteklenmeyen yerel dosyalar için istendiğinde tanımlanmamış olmalıdır.

  • isDirectory

    boole isteğe bağlı

    Dizin ise doğru değerini döndürü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 boş olmalıdır. options içinde istenirse sağlanmalıdır.

  • beden

    number isteğe bağlı

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

  • küçük resim

    string isteğe bağlı

    PNG, JPEG veya WEBP biçiminde, en fazla 32 KB boyutunda bir veri URI'si olarak 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+

Özellikler

  • actionId

    dize

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

  • entryPaths

    string[]

    Chrome 47 ve sonraki sürümler

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

  • fileSystemId

    dize

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

  • requestId

    sayı

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

FileSystemInfo

Özellikler

  • görünen ad

    dize

    Dosya sisteminin kullanıcılar tarafından okunabilen adı.

  • fileSystemId

    dize

    Dosya sisteminin tanımlayıcısı.

  • openedFiles

    OpenedFile[]

    Şu anda açık olan dosyaların listesi.

  • openedFilesLimit

    sayı

    Aynı anda açılabilecek maksimum dosya sayısı. 0 ise sınırlı değildir.

  • supportsNotifyTag

    boole isteğe bağlı

    Chrome 45+

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

  • izleyiciler

    Gözlemci[]

    Chrome 45+

    İzleyicilerin listesi.

  • yazılabilir

    boole

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

GetActionsRequestedOptions

Chrome 45+

Özellikler

  • entryPaths

    string[]

    Chrome 47 ve sonraki sürümler

    İşlem listesi için girişlerin 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ı.

GetMetadataRequestedOptions

Özellikler

  • cloudFileInfo

    boole

    Chrome 125 ve sonraki sürümler

    cloudFileInfo değeri istenirse true olarak ayarlanır.

  • cloudIdentifier

    boole

    Chrome 117 ve sonraki sürümler

    cloudIdentifier değeri istenirse true olarak ayarlanır.

  • entryPath

    dize

    Meta verileri alınacak girişin yolu.

  • fileSystemId

    dize

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

  • isDirectory

    boole

    Chrome 49+

    is_directory değeri istenirse true olarak ayarlanır.

  • mimeType

    boole

    Chrome 49+

    mimeType değeri istenirse true olarak ayarlanır.

  • modificationTime

    boole

    Chrome 49+

    modificationTime değeri istenirse true olarak ayarlanır.

  • ad

    boole

    Chrome 49 ve sonraki sürümler

    name değeri istenirse true olarak ayarlanır.

  • requestId

    sayı

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

  • beden

    boole

    Chrome 49+

    size değeri istenirse true olarak ayarlanır.

  • küçük resim

    boole

    thumbnail değeri istenirse true olarak ayarlanır.

MountOptions

Özellikler

  • görünen ad

    dize

    Dosya sisteminin kullanıcılar tarafından okunabilen adı.

  • fileSystemId

    dize

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

  • openedFilesLimit

    number isteğe bağlı

    Aynı anda açılabilecek maksimum dosya sayısı. Belirtilmezse veya 0 olarak ayarlanırsa sınırlama uygulanmaz.

  • kalıcı

    boole isteğe bağlı

    Chrome 64+

    Çerçevenin, bir sonraki oturum açma oturumunda dosya sistemini devam ettirip ettirmeyeceği. Varsayılan olarak doğrudur.

  • supportsNotifyTag

    boole isteğe bağlı

    Chrome 45+

    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 (dosya oluşturma, silme veya dosyalara yazma gibi) 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ı.

  • 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 yapılan 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

    Change[] 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.

  • özyinelemeli

    boole

    Gözlemlenen girişin modu.

  • etiket

    string isteğe bağlı

    Bildirimin etiketi. Dosya sistemi supportsNotifyTag seçeneğiyle bağlandıysa gereklidir. Bu işaretin, sistem kapalıyken bile yapılan 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 veya yazma için açılıp açılmadığı.

  • openRequestId

    sayı

    Ardışık okuma/yazma ve kapatma istekleri tarafından kullanılacak bir istek kimliği.

OpenFileMode

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

Enum

"READ"

"WRITE"

OpenFileRequestedOptions

Özellikler

  • filePath

    dize

    Açılacak dosyanın yolu.

  • fileSystemId

    dize

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

  • Dosyanın okuma veya yazma için kullanılıp kullanılmayacağı.

  • requestId

    sayı

    Ardışık okuma/yazma ve kapatma istekleri tarafından kullanılacak bir istek kimliği.

ProviderError

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

Enum

"Tamam"

"BAŞARISIZ OLDU"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"GÜVENLİK"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

Özellikler

  • directoryPath

    dize

    İçeriği istenen dizinin yolu.

  • fileSystemId

    dize

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

  • isDirectory

    boole

    Chrome 49+

    is_directory değeri istenirse true olarak ayarlanır.

  • mimeType

    boole

    Chrome 49+

    mimeType değeri istenirse true olarak ayarlanır.

  • modificationTime

    boole

    Chrome 49+

    modificationTime değeri istenirse true olarak ayarlanır.

  • ad

    boole

    Chrome 49+

    name değeri istenirse true olarak ayarlanır.

  • requestId

    sayı

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

  • beden

    boole

    Chrome 49+

    size değeri istenirse true olarak ayarlanır.

  • küçük resim

    boole

    Chrome 49+

    thumbnail değeri istenirse true olarak ayarlanır.

ReadFileRequestedOptions

Özellikler

  • fileSystemId

    dize

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

  • uzunluk

    sayı

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

  • telafi etmek

    sayı

    Dosyada okumaya başlanacak 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ı.

RemoveWatcherRequestedOptions

Özellikler

  • entryPath

    dize

    İzlenen girişin yolu.

  • fileSystemId

    dize

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

  • özyinelemeli

    boole

    Gözlemcinin modu.

  • requestId

    sayı

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

TruncateRequestedOptions

Özellikler

  • filePath

    dize

    Kısaltılacak dosyanın yolu.

  • fileSystemId

    dize

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

  • uzunluk

    sayı

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

  • requestId

    sayı

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

UnmountOptions

Özellikler

  • fileSystemId

    dize

    Bağlantısı kaldırılacak dosya sisteminin tanımlayıcısı.

UnmountRequestedOptions

Özellikler

  • fileSystemId

    dize

    Bağlantısı kaldırılacak dosya sisteminin tanımlayıcısı.

  • requestId

    sayı

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

Watcher

Özellikler

  • entryPath

    dize

    Gözlemlenen girişin yolu.

  • lastTag

    string isteğe bağlı

    İzleyici için son bildirim tarafından kullanılan etiket.

  • özyinelemeli

    boole

    İzlemenin tüm alt girişleri yinelemeli olarak içerip içermeyeceği. 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ı.

  • telafi etmek

    sayı

    Dosyada baytların yazılmaya başlanacağı 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ı.

Yöntemler

get()

Taahhüt 
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
): Promise<FileSystemInfo>

Geçirilen fileSystemId ile bir dosya sistemi hakkında bilgi döndürür.

Parametreler

  • fileSystemId

    dize

  • callback

    function isteğe bağlı

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

    (fileSystem: FileSystemInfo) => void

İadeler

  • Promise<FileSystemInfo>

    Chrome 96+

    get işlevinin sonucunu almak için geri çağırma.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getAll()

Taahhüt 
chrome.fileSystemProvider.getAll(
  callback?: function,
): Promise<FileSystemInfo[]>

Uzantı tarafından bağlanan tüm dosya sistemlerini döndürür.

Parametreler

  • callback

    function isteğe bağlı

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

    (fileSystems: FileSystemInfo[]) => void

İadeler

  • Promise<FileSystemInfo[]>

    Chrome 96+

    getAll işlevinin sonucunu almak için geri çağırma.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

mount()

Taahhüt 
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
): Promise<void>

Belirtilen fileSystemId ve displayName ile bir dosya sistemi bağlar. displayName, Dosyalar uygulamasının sol panelinde gösterilir. displayName, "/" dahil olmak üzere herhangi bir karakter içerebilir ancak boş bir dize olamaz. displayName açıklayıcı olmalıdır ancak benzersiz olması gerekmez. fileSystemId boş bir dize olmamalıdır.

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

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

Parametreler

  • seçenekler

    MountOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Başarı veya başarısızlığı belirten genel bir sonuç geri çağırma işlevi.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

notify()

Promise Chrome 45+ 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
): Promise<void>

recursive modunda observedPath adresindeki izlenen dizinde yapılan değişiklikleri bildirir. Dosya sistemi supportsNotifyTag ile bağlanırsa tag sağlanmalıdır ve sistem kapatılmış olsa bile son bildirimden bu yana yapılan tüm değişiklikler her zaman raporlanır. Son etiket getAll ile alınabilir.

Kullanmak için file_system_provider.notify manifest seçeneği "true" olarak ayarlanmalıdır.

tag değeri, her çağrı için benzersiz olan herhangi bir dize olabilir. Bu sayede, kayıtlı son bildirim tanımlanabilir. Örneğin, sağlayan uzantı yeniden başlatma işleminden sonra başlarsa ve son kayıtlı bildirimin etiketi "123"e eşitse "123" olarak etiketlenen değişiklikten sonra gerçekleşen tüm değişiklikler için notify yöntemini çağırmalıdır. Boş bir dize olamaz.

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

Bir üst dizin kaldırılırsa tüm alt girişlerin de kaldırılacağını ve izleniyorlarsa API'nin bu durumdan haberdar edilmesi gerektiğini unutmayın. Ayrıca, bir dizin yeniden adlandırılırsa orijinal yollarının altında artık giriş olmadığından tüm alt girişler kaldırılır.

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

Parametreler

  • seçenekler

    NotifyOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Başarı veya başarısızlığı belirten genel bir sonuç geri çağırma işlevi.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

unmount()

Taahhüt 
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
): Promise<void>

Belirtilen fileSystemId ile bir dosya sisteminin bağlantısını kaldırır. onUnmountRequested çağrıldıktan sonra çağrılmalıdır. Ayrıca, sağlayıcı uzantı, istenmediği takdirde bağlantıyı kesmeye karar verebilir (ör. bağlantı kesilmesi veya dosya hatası durumunda).

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

Parametreler

  • seçenekler

    UnmountOptions

  • callback

    function isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96+

    Başarı veya başarısızlığı belirten genel bir sonuç geri çağırma işlevi.

    Promise'ler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onAbortRequested

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

operationRequestId ile bir işlemi iptal etme isteği gönderildiğinde ortaya çıkar. operationRequestId ile yürütülen işlem hemen durdurulmalı ve bu iptal isteğinin successCallback yürütülmelidir. İptal işlemi başarısız olursa errorCallback çağrılmalıdır. İptal edilen işlemin geri çağırmaları yoksayılacağından çağrılmamalıdır. errorCallback çağrılmasına rağmen istek zorla iptal edilebilir.

Parametreler

  • callback

    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+ 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Yeni bir dizin izleyici ayarlanması istendiğinde tetiklenir. Hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • callback

    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 dosyanın kapatılması istendiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

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

onConfigureRequested

Chrome 44+ 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

fileSystemId için yapılandırma iletişim kutusunun gösterilmesi istendiğinde tetiklenir. İşleniyorsa file_system_provider.configurable manifest seçeneği doğru değerine ayarlanmalıdır.

Parametreler

  • callback

    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şin kopyalanması (dizin ise yinelemeli olarak) istendiğinde tetiklenir. Hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • callback

    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 tetiklenir. Hedef dizin zaten mevcutsa işlem EXISTS hatasıyla başarısız olmalıdır. recursive doğruysa dizin yolundaki tüm eksik dizinler oluşturulmalıdır.

Parametreler

onCreateFileRequested

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

Dosya oluşturma isteği gönderildiğinde tetiklenir. Dosya zaten mevcutsa errorCallback, "EXISTS" hata koduyla çağrılmalıdır.

Parametreler

  • callback

    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şin silinmesi istendiğinde tetiklenir. recursive doğruysa ve giriş bir dizinse içindeki tüm girişler de yinelemeli olarak silinmelidir.

Parametreler

  • callback

    işlev

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

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

onExecuteActionRequested

Chrome 48+ 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Bir dizi dosya veya dizin için işlem yürütme istendiğinde tetiklenir. İşlem tamamlandıktan sonra successCallback çağrılmalıdır. Hata durumunda errorCallback çağrılmalıdır.

Parametreler

  • callback

    işlev

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

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

onGetActionsRequested

Chrome 48+ 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

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

Parametreler

  • callback

    işlev

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

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

onGetMetadataRequested

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

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

Parametreler

onMountRequested

Chrome 44+ 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

Yeni bir dosya sistemi bağlamak için iletişim kutusu gösterilmesi istendiğinde tetiklenir. Uzantı/uygulama bir dosya işleyiciyse bu etkinlik işlenmemelidir. Bunun yerine, bir dosya açıldığında yeni dosya sistemlerini bağlamak için app.runtime.onLaunched işlenmelidir. Birden fazla bağlama için file_system_provider.multiple_mounts manifest seçeneği "true" olarak ayarlanmalıdır.

Parametreler

  • callback

    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şin taşınması (dizin ise yinelemeli olarak) istendiğinde tetiklenir. Hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • callback

    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 konumundaki bir dosyanın açılması istendiğinde tetiklenir. 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 konumundaki bir dizinin içeriği istendiğinde tetiklenir. Sonuçlar, successCallback birkaç kez çağrılarak parçalar halinde döndürülmelidir. Hata 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ğinin okunması istendiğinde ortaya çıkar. Sonuçlar, successCallback birkaç kez çağrılarak parçalar halinde döndürülmelidir. Hata durumunda errorCallback çağrılmalıdır.

Parametreler

  • callback

    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

        boole

    • errorCallback

      işlev

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

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45+ 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

İzleyici kaldırılması gerektiğinde tetiklenir. Hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • callback

    işlev

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

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

onTruncateRequested

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

Bir dosyanın istenen uzunluğa kısaltılması istendiğinde tetiklenir. Hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • callback

    işlev

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

    (options: TruncateRequestedOptions, 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

onUnmountRequested

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

fileSystemId tanımlayıcısına sahip dosya sisteminin bağlantısının kesilmesi istendiğinde tetiklenir. Yanıtta, unmount API yöntemi successCallback ile birlikte çağrılmalıdır. Çıkarma işlemi mümkün değilse (ör. bekleyen bir işlem nedeniyle) errorCallback çağrılmalıdır.

Parametreler

  • callback

    işlev

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

    (options: UnmountRequestedOptions, 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

onWriteFileRequested

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

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

Parametreler

  • callback

    işlev

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

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