chrome.fileSystemProvider

Açıklama

ChromeOS'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

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 şekilde beyan edilmelidir:

configurable (boolean) - isteğe bağlı
onConfigureRequested aracılığıyla yapılandırmanın desteklenip desteklenmediği. Varsayılan olarak: false.
multiple_mounts (boolean) - isteğe bağlı
Birden fazla (ikiden fazla) bağlı dosya sisteminin desteklenip desteklenmediği. Varsayılan olarak: false.
watchable (boolean) - isteğe bağlı
Ayarlara izleyici ekleme 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 sistemlerindeki verilerin 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 değerine ayarlanırsa ses düzeylerini yapılandırmak 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. Kullanım alanları arasında arşivleri açma ve Drive dışındaki bir bulut hizmetindeki dosyalara erişme yer alır.

Dosya sistemlerini bağlama

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

Dosya işleyici olan dosya sistemleri (kaynak "file") yazmak için sağlayıcı, paketlenmiş bir 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 içerikleri ağ üzerinden sağlayan dosya sistemlerinde uygun kimlik bilgilerini ayarlamak için yararlı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 veya 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 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ığı. Sık kullanılan işlemler için yok sayılabilir.

AddWatcherRequestedOptions

Özellikler

  • entryPath

    dize

    İzlenecek girişin yolu.

  • fileSystemId

    dize

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

  • özyinelemeli

    boolean

    Gözlemleme işleminin 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 veya daha yeni bir sürüm

    Bulut dosya sistemi tarafından destekleniyorsa 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 veya daha yeni bir sürüm

Ö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 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ı gerekmediğini 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

    boolean

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

    boolean

    İş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 veya daha yeni bir sürüm

    Temel alınan bulut dosya sistemindeki belirli bir dosyayı tanımlayan bilgiler. options içinde isteniyorsa ve dosya bulut depolama alanıyla destekleniyorsa sağlanmalıdır.

  • cloudIdentifier

    CloudIdentifier isteğe bağlı

    Chrome 117 ve sonraki sürümler

    Bu girişin Cloud Storage'deki temsili. options içinde isteniyorsa ve dosya bulut depolama alanıyla destekleniyorsa 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 istenirse 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ıdır.

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

  • ad

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

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

  • küçük resim

    dize isteğe bağlı

    PNG, JPEG veya WEBP biçiminde, en fazla 32 KB boyutunda 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 veya daha yeni bir sürüm

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

    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

    string[]

    Chrome 47 veya daha yeni bir sürüm

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

    boolean

    Chrome 125 veya daha yeni bir sürüm

    cloudFileInfo değeri isteniyorsa true olarak ayarlayın.

  • cloudIdentifier

    boolean

    Chrome 117 ve sonraki sürümler

    cloudIdentifier değeri isteniyorsa true olarak ayarlayın.

  • entryPath

    dize

    Hakkında meta veri getirilecek girişin yolu.

  • fileSystemId

    dize

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

  • isDirectory

    boolean

    Chrome 49 veya daha yeni bir sürüm

    is_directory değeri isteniyorsa true olarak ayarlayın.

  • mimeType

    boolean

    Chrome 49 veya daha yeni bir sürüm

    mimeType değeri isteniyorsa true olarak ayarlayın.

  • modificationTime

    boolean

    Chrome 49 veya daha yeni bir sürüm

    modificationTime değeri isteniyorsa true olarak ayarlayın.

  • ad

    boolean

    Chrome 49 veya daha yeni bir sürüm

    name değeri isteniyorsa true olarak ayarlayın.

  • requestId

    sayı

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

  • beden

    boolean

    Chrome 49 veya daha yeni bir sürüm

    size değeri isteniyorsa true olarak ayarlayın.

  • küçük resim

    boolean

    thumbnail değeri isteniyorsa true olarak ayarlayın.

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ı. Belirtilmemişse veya 0 ise sınırlanmaz.

  • 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ğru (true) değerini alır.

  • supportsNotifyTag

    boolean isteğe bağlı

    Chrome 45 ve sonraki sürümler

    Dosya sisteminin, izlenen 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 meydana gelen değişikliğin türü. Silinirse gözlemlenen giriş, gözlemlenen girişler listesinden otomatik olarak kaldırılır.

  • değişiklikler

    Değiştir[] 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

    boolean

    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

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

Enum

"OK"

"FAILED"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SECURITY"

"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

    boolean

    Chrome 49 veya daha yeni bir sürüm

    is_directory değeri isteniyorsa true olarak ayarlayın.

  • mimeType

    boolean

    Chrome 49 veya daha yeni bir sürüm

    mimeType değeri isteniyorsa true olarak ayarlayın.

  • modificationTime

    boolean

    Chrome 49 veya daha yeni bir sürüm

    modificationTime değeri isteniyorsa true olarak ayarlayın.

  • ad

    boolean

    Chrome 49 veya daha yeni bir sürüm

    name değeri isteniyorsa true olarak ayarlayın.

  • requestId

    sayı

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

  • beden

    boolean

    Chrome 49 veya daha yeni bir sürüm

    size değeri isteniyorsa true olarak ayarlayın.

  • küçük resim

    boolean

    Chrome 49 veya daha yeni bir sürüm

    thumbnail değeri isteniyorsa true olarak ayarlayın.

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

    boolean

    İ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

    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

    İzlenen girişin yolu.

  • lastTag

    dize isteğe bağlı

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

  • özyinelemeli

    boolean

    İzleme işlemine tüm alt girişlerin yinelemeli olarak dahil edilip edilmeyeceği. Bu durum yalnızca dizinler için geçerli olabilir.

WriteFileRequestedOptions

Özellikler

  • aktarma

    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()

chrome.fileSystemProvider.get(
  fileSystemId: string,
): Promise<FileSystemInfo>

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

Parametreler

  • fileSystemId

    dize

İadeler

  • Promise<FileSystemInfo>

    Chrome 96 ve sonraki sürümler

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

getAll()

chrome.fileSystemProvider.getAll(): Promise<FileSystemInfo[]>

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

İadeler

  • Promise<FileSystemInfo[]>

    Chrome 96 ve sonraki sürümler

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

mount()

chrome.fileSystemProvider.mount(
  options: MountOptions,
): 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

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

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

notify()

Chrome 45 ve sonraki sürümler 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
): Promise<void>

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

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

tag değeri, her görüşme için benzersiz olan herhangi bir dize olabilir. Bu nedenle, son kaydedilen bildirimi tanımlamak mümkündür. Örneğin, sağlama uzantısı 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ş bir 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

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

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

unmount()

chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
): Promise<void>

Belirtilen fileSystemId ile bir dosya sistemini ayırır. Bu işlev, 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

İadeler

  • Promise<void>

    Chrome 96 ve sonraki sürümler

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

Etkinlikler

onAbortRequested

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

operationRequestId ile bir işlemin iptal edilmesi istendiğinde 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 yok sayılacağından çağrılmaması gerektiğini unutmayın. errorCallback çağrısı yapı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 ayarlama isteğinde bulunulduğunda tetiklenir. Hata oluşursa errorCallback aranmalı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 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 aranmalı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 veya daha yeni bir sürüm 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

Bir dosya veya dizin grubu için işlem yürütme isteğinde bulunulduğunda 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 veya daha yeni bir sürüm 
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 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 sisteminin bağlanması için iletişim kutusu gösterilmesi istendiğinde oluşturulur. 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 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 aranmalı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 dosya açılması istendiğinde oluşturulur. 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çılan 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

      • aktarma

        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 tetiklenir. Hata oluşursa errorCallback aranmalı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 aranmalı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 ayırma isteğinde bulunulduğunda oluşturulur. Yanıt olarak unmount API yöntemi, successCallback ile birlikte çağrılmalıdır. Ayırma 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çılan bir dosyaya içerik yazılması istendiğinde oluşturulur.

Parametreler

  • callback

    işlev

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

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