chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

Açıklama

Chrome OS'teki dosya yöneticisinden erişilebilen dosya sistemleri oluşturmak için chrome.fileSystemProvider API'sini 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 (boolean) - isteğe bağlı
onConfigureRequested üzerinden yapılandırmanın desteklenip desteklenmediği. Varsayılan olarak: false.
multiple_mounts (boolean) - isteğe bağlı
Birden fazla (birden fazla) bağlı dosya sisteminin desteklenip desteklenmediği. Varsayılan olarak: false.
watchable (boolean) - isteğe bağlı
İzleyici ayarlama ve değişiklikler hakkında bildirim gönderme özelliklerinin desteklenip desteklenmediği. Varsayılan olarak: false.
source ("file", "device" veya "network" enum'ı) - zorunlu
Bağlı dosya sistemleri için veri kaynağı.

Dosyalar uygulaması, ilgili kullanıcı arayüzü öğelerini uygun şekilde oluşturmak için yukarıdaki bilgileri kullanır. Örneğin, configurable doğru olarak ayarlanırsa birimlerin yapılandırılması için bir menü öğesi oluşturulur. Benzer şekilde, multiple_mounts true olarak ayarlanırsa Dosyalar uygulaması, kullanıcı arayüzünden birden fazla bağlama noktası eklenmesine izin verir. watchable, false ise yenileme düğmesi oluşturulur. Mümkünse izleyiciler için destek eklemeniz gerektiğini unutmayın. Böylece dosya sistemindeki değişiklikler anında 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ğlanan uzantılar, harici bir kaynaktan (ör. uzak sunucu veya USB cihaz) dosya sistemi içerikleri sağlayabilir ya da giriş olarak yerel bir dosya (ör. arşiv) kullanabilir.

Dosya işleyici olan dosya sistemlerini yazmak için (kaynak "file") sağlayıcı, paket uygulama olmalıdır. Çünkü onLaunched etkinliği uzantılarda kullanılamaz.

Kaynak ağ veya cihaz ise 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 özellik, özellikle uygun kimlik bilgilerini ayarlamak için içerikleri ağ üzerinden 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, bir kez bağlandıktan sonra Chrome tarafından hatırlanır ve yeniden başlatma veya yeniden başlatmanın ardından 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 unmount yöntemi çağrılana kadar bağlı kalır.

Türler

AbortRequestedOptions

Özellikler

  • fileSystemId

    dize

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

  • operationRequestId

    sayı

    Durdurulacak isteğin kimliği.

  • requestId

    sayı

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

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

    dize isteğe bağlı

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

AddWatcherRequestedOptions

Özellikler

  • entryPath

    dize

    İzlenecek 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çermesi gerekip gerekmediği. Bu durum yalnızca dizinler için geçerli 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 yedeklenen dosyayla ilgili bilgiler.

  • entryPath

    dize

    Değiştirilen girişin yolu.

ChangeType

İzlenen 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

    dize 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

    Belirli 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", dosyaları başkalarıyla paylaşmak için kullanılır. "SAVE_FOR_OFFLINE" simgesine dokunarak sabitleyebilirsiniz (çevrimdışı erişim için kaydetme). "OFFLINE_NOT_NECESSARY", dosyanın artık çevrimdışı erişim için depolanmasına gerek olmadığını bildirmek için kullanılır. onGetActionsRequested ve onExecuteActionRequested tarafından kullanılır.

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"PAYLAŞ"

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

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 alınan bulut dosya sistemindeki belirli bir dosyayı tanımlayan bilgiler. options içinde isteniyorsa ve dosya bulut depolama alanında yedekleniyorsa 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ında yedekleniyorsa sağlanmalıdır. Bulut depolama alanı tarafından yedeklenmeyen yerel dosyalar için istendiğinde tanımsız olmalıdır.

  • isDirectory

    boolean isteğe bağlı

    Dizinse doğru değerini döndürür. options içinde isteniyorsa sağlanmalıdır.

  • mimeType

    dize 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 isteniyorsa sağlanmalıdır.

  • ad

    dize isteğe bağlı

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

  • beden

    number isteğe bağlı

    Dosyanın bayt cinsinden boyutu. options içinde isteniyorsa sağlanmalıdır.

  • küçük resim

    dize 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 ve sonraki sürümler

Ö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 yollarının kümesi.

  • 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 okunabilecek 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

    boolean 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

    Watcher[]

    Chrome 45 ve sonraki sürümler

    İzleyenlerin listesi.

  • yazılabilir

    boole

    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

    string[]

    Chrome 47 ve sonraki sürümler

    İşlem listesindeki 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 isteniyorsa true olarak ayarlanır.

  • cloudIdentifier

    boole

    Chrome 117 ve sonraki sürümler

    cloudIdentifier değeri isteniyorsa true olarak ayarlanır.

  • entryPath

    dize

    Hakkında meta veri getirilecek girişin yolu.

  • fileSystemId

    dize

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

  • isDirectory

    boole

    Chrome 49 veya daha yeni bir sürüm

    is_directory değeri isteniyorsa true olarak ayarlanır.

  • mimeType

    boole

    Chrome 49 veya daha yeni bir sürüm

    mimeType değeri isteniyorsa true olarak ayarlanır.

  • modificationTime

    boole

    Chrome 49 veya daha yeni bir sürüm

    modificationTime değeri isteniyorsa true olarak ayarlanır.

  • ad

    boole

    Chrome 49 veya daha yeni bir sürüm

    name değeri isteniyorsa true olarak ayarlanır.

  • requestId

    sayı

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

  • beden

    boole

    Chrome 49 veya daha yeni bir sürüm

    size değeri isteniyorsa true olarak ayarlanır.

  • küçük resim

    boole

    thumbnail değeri isteniyorsa true olarak ayarlanır.

MountOptions

Özellikler

  • görünen ad

    dize

    Dosya sisteminin kullanıcılar tarafından okunabilecek 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 ise sınırlı değildir.

  • kalıcı

    boolean isteğe bağlı

    Chrome 64 veya daha yeni bir sürüm

    Çerçevenin, bir sonraki oturum açma işleminde dosya sistemine devam edip etmeyeceği. Varsayılan olarak doğrudur.

  • supportsNotifyTag

    boolean 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

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

  • 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İYSE gözlemlenen giriş, gözlemlenen girişler listesinden otomatik olarak kaldırılır.

  • değişiklikler

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

    İzlenen 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

    dize isteğe bağlı

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

  • openRequestId

    sayı

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

OpenFileMode

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

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 isteklerinde kullanılacak bir istek kimliği.

ProviderError

Uzantıların isteklere yanıt verirken ve API yöntemleri çağrılırken hata oluşması durumunda kullandığı hata kodları. Başarı için "OK" kullanılmalıdır.

Enum

"Tamam"

"FAILED"

"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

    İçeriklerinin istenildiği dizinin yolu.

  • fileSystemId

    dize

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

  • isDirectory

    boole

    Chrome 49 veya daha yeni bir sürüm

    is_directory değeri isteniyorsa true olarak ayarlanır.

  • mimeType

    boole

    Chrome 49 veya daha yeni bir sürüm

    mimeType değeri isteniyorsa true olarak ayarlanır.

  • modificationTime

    boole

    Chrome 49 veya daha yeni bir sürüm

    modificationTime değeri isteniyorsa true olarak ayarlanır.

  • ad

    boole

    Chrome 49 veya daha yeni bir sürüm

    name değeri isteniyorsa true olarak ayarlanır.

  • requestId

    sayı

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

  • beden

    boole

    Chrome 49 veya daha yeni bir sürüm

    size değeri isteniyorsa true olarak ayarlanır.

  • küçük resim

    boole

    Chrome 49 veya daha yeni bir sürüm

    thumbnail değeri isteniyorsa 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ı

    Okumaya başlamak için 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ı.

RemoveWatcherRequestedOptions

Özellikler

  • entryPath

    dize

    İzlenen girişin yolu.

  • fileSystemId

    dize

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

  • özyinelemeli

    boole

    İzleyicinin modu.

  • requestId

    sayı

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

TruncateRequestedOptions

Özellikler

  • filePath

    dize

    Kırpı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

    Dosya sisteminin tanımlayıcısı (bağlantısı kaldırılacak).

UnmountRequestedOptions

Özellikler

  • fileSystemId

    dize

    Dosya sisteminin tanımlayıcısı (bağlantısı kaldırılacak).

  • requestId

    sayı

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

Watcher

Özellikler

  • entryPath

    dize

    İzlenen girişin yolu.

  • lastTag

    dize isteğe bağlı

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

  • özyinelemeli

    boole

    İzlemenin tüm alt girişleri yinelemeli olarak içerip içermeyeceği. Bu durum yalnızca dizinler için geçerli 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ı

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

Yöntemler

get()

Promise 
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

    işlev isteğe bağlı

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

    (fileSystem: FileSystemInfo) => void

İadeler

  • Promise<FileSystemInfo>

    Chrome 96 ve sonraki sürümler

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getAll()

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

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

Parametreler

  • callback

    işlev isteğe bağlı

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

    (fileSystems: FileSystemInfo[]) => void

İadeler

  • Promise<FileSystemInfo[]>

    Chrome 96 ve sonraki sürümler

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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

mount()

Promise 
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 karakteri 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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Başarıyı veya başarısızlığı belirtmek için genel bir sonuç geri araması.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

notify()

Promise Chrome 45 veya daha yeni bir sürüm 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
): Promise<void>

recursive modunda observedPath konumundaki izlenen dizinde yapılan değişiklikler hakkında bildirim gönderir. Dosya sistemi supportsNotifyTag ile monte edilmişse tag sağlanmalıdır ve sistem kapatılmış olsa bile son bildirimden bu yana yapılan tüm değişiklikler her zaman bildirilir. Son etiket, getAll ile elde edilebilir.

Bu özelliği kullanmak için file_system_provider.notify manifest seçeneği doğru olarak ayarlanmalıdır.

tag değeri, her çağrı için benzersiz olan herhangi bir dize olabilir. Bu nedenle, son kaydedilen bildirimi tanımlamak mümkündür. Örneğin, sağlayan uzantı yeniden başlatma işleminden sonra başlıyorsa ve son kaydedilen 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 çağrısı yapılmalıdır. Boş dize olamaz.

Tüm sağlayıcılar etiket sağlayamaz ancak dosya sisteminde 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 izleniyorsa API'nin bu durumdan haberdar edilmesi gerektiğini unutmayın. Ayrıca, bir dizinin adı değiştirilirse orijinal yolları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

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Başarıyı veya başarısızlığı belirtmek için genel bir sonuç geri araması.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

unmount()

Promise 
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ğlayan uzantı, istenmediği takdirde (ör. bağlantı kaybı veya dosya hatası durumunda) kaldırma işlemi yapmaya karar verebilir.

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

Parametreler

  • seçenekler

    UnmountOptions

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

    Başarıyı veya başarısızlığı belirtmek için genel bir sonuç geri araması.

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onAbortRequested

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

operationRequestId ile bir işlemi durdurma isteğinde bulunulduğunda oluşturulur. operationRequestId ile yürütülen işlem hemen durdurulmalı ve bu iptal isteğinin successCallback yürütülmelidir. Durdurma işlemi başarısız olursa errorCallback çağrılmalıdır. İptal edilen işlemin geri çağırmalarının yoksayılacağından çağrılmaması gerektiğini unutmayın. errorCallback çağrılmasına rağmen istek zorla durdurulabilir.

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 ve sonraki sürümler 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

Yeni bir dizin izleyicisi 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 ve sonraki sürümler 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

fileSystemId için bir yapılandırma iletişim kutusu gösterilmesi istendiğinde tetiklenir. İşleniyorsa file_system_provider.configurable manifest seçeneği doğru olarak 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şi kopyalama (dizinse yinelemeli olarak) istendiğinde oluşturulur. 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 isteğinde bulunulduğunda tetiklenir. Hedef dizin zaten varsa 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ğinde bulunulduğunda tetiklenir. Dosya zaten varsa 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 ve sonraki sürümler 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Bir dosya veya dizin grubu için işlem yürütülmesi istendiğinde oluşturulur. İş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 ve sonraki sürümler 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

entryPaths konumundaki bir dosya veya dizin grubu için işlem listesi istendiğinde oluşturulur. 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 birlikte 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 oluşturulur. Meta veriler, successCallback çağrısıyla birlikte döndürülmelidir. Hata 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 sistemini 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 montaj için file_system_provider.multiple_mounts manifest seçeneği doğru 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şi taşıma (dizinse yinelemeli olarak) isteğinde bulunulduğunda oluşturulur. 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 konumunda bir dosyanın açılması istendiğinde tetiklenir. Dosya yoksa 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 oluşturulur. 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ği okunmak istendiğinde oluşturulur. 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 ve sonraki sürümler 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

İzleyicinin 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 uzunlukta kesilmesi istendiğinde oluşturulur. 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 sistemi için bağlantıyı kaldırma isteğinde bulunulduğunda oluşturulur. Yanıt olarak, unmount API yöntemi successCallback ile birlikte çağrılmalıdır. Ayırma 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 yazma isteğinde bulunulduğunda tetiklenir.

Parametreler

  • callback

    işlev

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

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