chrome.fileSystemProvider

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 'nı inceleyin.

Manifest

"fileSystemProvider" tanımlamanız gerekir uzantı manifesti'ndeki File System Provider API'sini kullanmak için izin ve bölüm bölümlerine izin verin. Örneğin:

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

file_system_provider bölümü aşağıdaki gibi belirtilmelidir:

configurable (boole) - isteğe bağlı
onConfigureRequest aracılığıyla yapılandırmanın desteklenip desteklenmediğini belirtir. Varsayılan olarak: false.
multiple_mounts (boole) - isteğe bağlı
Birden fazla (birden fazla) eklenmiş dosya sisteminin desteklenip desteklenmediği Varsayılan olarak: false.
watchable (boole) - isteğe bağlı
İzleyicileri ayarlama ve değişiklikler hakkında bilgilendirmenin desteklenip desteklenmediği Varsayılan olarak: false.
source ("dosya", "cihaz" veya "ağ" sıralaması) - gerekli
Eklenmiş 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 doğru değerine ayarlanırsa birimleri yapılandırmaya yönelik bir menü öğesi oluşturulur. Benzer şekilde, multiple_mounts politikası true olarak ayarlanırsa Dosyalar uygulaması, kullanıcı arayüzünden birden fazla ekleme noktası eklenmesine izin verir. watchable değeri false ise yenileme düğmesi oluşturulur. Dosya sistemindeki değişikliklerin anında ve otomatik olarak yansıtılabilmesi için mümkünse izleyiciler için destek eklemeniz gerektiğini unutmayın.

Genel Bakış

Dosya Sistemi Sağlayıcı API'si, uzantıların sanal dosya sistemlerini desteklemesine olanak tanır. Bu sistemler, ChromeOS'teki dosya yöneticisinde bulunur. Kullanım alanları arasında arşivlerin sıkıştırmasını açmak ve Drive dışında bir bulut hizmetinde dosyalara erişmek yer alır.

Dosya sistemlerini ekleme

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

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

Kaynak ağ veya cihaz ise onMountRequested etkinliği çağrıldığında dosya sisteminin eklenmesi gerekir.

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

Dosya sistemlerini yapılandırma

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

Yaşam döngüsü

Sağlanan dosya sistemleri, eklendikten sonra Chrome tarafından hatırlanır ve yeniden başlatma veya yeniden başlatma sonrasında otomatik olarak yeniden eklenir. Bu nedenle, bir dosya sistemi, sağlayan bir uzantı tarafından eklendikten 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 ve sonraki sürümler 'nı inceleyin.

Ö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şlemlerde yoksayılabilir.

AddWatcherRequestedOptions

Özellikler

  • entryPath

    dize

    Gözlemlenecek girişin yolu.

  • fileSystemId

    dize

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

  • yinelemeli

    boolean

    Gö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 gerçekleşen değişikliğin türü.

  • cloudFileInfo

    CloudFileInfo isteğe bağlı

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

    Bulut dosya sistemi tarafından destekleniyorsa dosyayla ilgili bilgiler.

  • entryPath

    dize

    Değiştirilen girişin yolu.

ChangeType

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

Enum

"DEĞİŞTİRİLDİ"

"SİLİNDİ"

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 'nı inceleyin.

Ö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 'nı inceleyin.

Özellikler

  • id

    dize

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

  • providerName

    dize

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

CommonActionId

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

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

Enum

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"PAYLAŞ"

ConfigureRequestedOptions

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

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

  • yinelemeli

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

  • yinelemeli

    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 ve sonraki sürümler 'nı inceleyin.

    Temel bulut dosya sistemindeki belirli bir dosyayı tanımlayan bilgiler. options içinde istendiğinde 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 'nı inceleyin.

    Bu girişin Cloud Storage temsili. options içinde istendiğinde 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.

  • Dizin

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

    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 bu değer boş olmalıdır. options içinde istenirse sağlanmalıdır.

  • beden

    sayı isteğe bağlı

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

  • küçük resim

    dize isteğe bağlı

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

ExecuteActionRequestedOptions

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

Özellikler

  • actionId

    dize

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

  • entryPaths

    dize[]

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

    İşlem için kullanılacak girişlerin yol 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 sistemi için okunabilir bir ad.

  • fileSystemId

    dize

    Dosya sisteminin tanımlayıcısı.

  • openedFiles

    OpenedFile[]

    Açık olan dosyaların listesi.

  • openedFilesLimit

    sayı

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

  • supportsNotifyTag

    boole isteğe bağlı

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

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

  • izleyiciler

    İzleyici[]

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

    İzleyici 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 'nı inceleyin.

Özellikler

  • entryPaths

    dize[]

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

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

  • fileSystemId

    dize

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

  • requestId

    sayı

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

GetMetadataRequestedOptions

Özellikler

  • cloudFileInfo

    boolean

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

    cloudFileInfo değeri istenirse true olarak ayarlayın.

  • cloudIdentifier

    boolean

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

    cloudIdentifier değeri istenirse true olarak ayarlayın.

  • entryPath

    dize

    Meta verilerin getirileceği girişin yolu.

  • fileSystemId

    dize

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

  • Dizin

    boolean

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

    is_directory değeri istenirse true olarak ayarlayın.

  • mimeType

    boolean

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

    mimeType değeri istenirse true olarak ayarlayın.

  • modificationTime

    boolean

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

    modificationTime değeri istenirse true olarak ayarlayın.

  • ad

    boolean

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

    name değeri istenirse true olarak ayarlayın.

  • requestId

    sayı

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

  • beden

    boolean

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

    size değeri istenirse true olarak ayarlayın.

  • küçük resim

    boolean

    thumbnail değeri istenirse true olarak ayarlayın.

MountOptions

Özellikler

  • görünen ad

    dize

    Dosya sistemi için okunabilir bir ad.

  • fileSystemId

    dize

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

  • openedFilesLimit

    sayı isteğe bağlı

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

  • kalıcı

    boole isteğe bağlı

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

    Çerçevenin bir sonraki oturum açma oturumunda dosya sistemini devam ettirip sürdürmeyeceğini belirler. Varsayılan olarak doğru değerine sahiptir.

  • supportsNotifyTag

    boole isteğe bağlı

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

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

  • yazılabilir

    boole isteğe bağlı

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

MoveEntryRequestedOptions

Özellikler

  • fileSystemId

    dize

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

  • requestId

    sayı

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

  • sourcePath

    dize

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

  • targetPath

    dize

    Kopyalama işleminin hedef yolu.

NotifyOptions

Özellikler

  • changeType

    ChangeType

    Gözlemlenen girişte gerçekleşen değişikliğin türü. DELETED ise 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 sistemi tanımlayıcısı.

  • observedPath

    dize

    Gözlemlenen girişin yolu.

  • yinelemeli

    boolean

    Gözlemlenen girişin modu.

  • etiket

    dize isteğe bağlı

    Bildirim etiketi. Dosya sistemi supportsNotifyTag seçeneğiyle eklendiyse gereklidir. Bu işaretin, sistem kapatıldığında bile değişen değişikliklerle ilgili bildirim 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ı

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

OpenFileMode

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

Enum

"OKU"

"YAZ"

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ı

    Art arda gelen okuma/yazma ve kapatma istekleri tarafından kullanılacak istek kimliği.

ProviderError

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

Enum

"Tamam"

"BAŞARISIZ"

"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"

"KS"

ReadDirectoryRequestedOptions

Özellikler

  • directoryPath

    dize

    İçeriğin istendiği dizinin yolu.

  • fileSystemId

    dize

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

  • Dizin

    boolean

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

    is_directory değeri istenirse true olarak ayarlayın.

  • mimeType

    boolean

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

    mimeType değeri istenirse true olarak ayarlayın.

  • modificationTime

    boolean

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

    modificationTime değeri istenirse true olarak ayarlayın.

  • ad

    boolean

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

    name değeri istenirse true olarak ayarlayın.

  • requestId

    sayı

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

  • beden

    boolean

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

    size değeri istenirse true olarak ayarlayın.

  • küçük resim

    boolean

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

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

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

  • yinelemeli

    boolean

    İzleyici 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ı kesilecek dosya sisteminin tanımlayıcısı.

UnmountRequestedOptions

Özellikler

  • fileSystemId

    dize

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

  • requestId

    sayı

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

Watcher

Özellikler

  • entryPath

    dize

    Gözlemlenen girişin yolu.

  • lastTag

    dize isteğe bağlı

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

  • yinelemeli

    boolean

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

WriteFileRequestedOptions

Özellikler

  • veri

    DiziArabelleği

    Dosyaya yazılacak baytlık arabellek.

  • fileSystemId

    dize

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

  • telafi etmek

    sayı

    Dosyadaki baytları yazmaya başlamak için kullanılacak 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()

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

İletilen fileSystemId ile dosya sistemi hakkında bilgileri döndürür.

Parametreler

  • fileSystemId

    dize

  • geri çağırma

    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 'nı inceleyin.

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

getAll()

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

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

Parametreler

  • geri çağırma

    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 'nı inceleyin.

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

mount()

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

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

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

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

Parametreler

  • seçenekler

    MountOptions

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

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

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

notify()

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

recursive modunda observedPath itibarıyla izlenen dizinde yapılan değişiklikleri bildirir. Dosya sistemi supportsNotifyTag ile eklenirse 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 elde edilebilir.

Bunun 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. Ör. Sağlayan uzantı yeniden başlatma işleminden sonra başlıyor ve son kaydedilen bildirimin etiketi "123" ise, değişikliğin "123" olarak etiketlenmesinden bu yana gerçekleşen tüm değişiklikler için notify çağrısı gerekir. Boş dize olamaz.

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

Bir üst dizin kaldırılırsa tüm alt girişlerin de kaldırılacağını ve izlemelerinin izlenmesi durumunda API'ye olay hakkında bilgi verilmesi gerektiğini unutmayın. Ayrıca, bir dizin yeniden adlandırılırsa artık orijinal yollarının altında herhangi bir giriş bulunmadığından tüm alt girişler aslında kaldırılır.

Hata olması durumunda runtime.lastError için ilgili hata kodu ayarlanır.

Parametreler

  • seçenekler

    NotifyOptions

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

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

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

unmount()

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

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

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

Parametreler

  • seçenekler

    UnmountOptions

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<void>

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

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

Etkinlikler

onAbortRequested

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

operationRequestId ile bir işlemi iptal etme isteğinde bulunulduğunda üretildi. operationRequestId ile yürütülen işlem hemen durdurulmalı ve bu iptal isteğinin successCallback kadarı yürütülmelidir. İptal işlemi başarısız olursa errorCallback çağrılmalıdır. İptal edilen işlemin geri çağırmaları yok sayılacağından, çağrılmamaları gerektiğini unutmayın. errorCallback numaralı telefonun aranmasına rağmen istek zorla iptal edilebilir.

Parametreler

  • geri çağırma

    işlev

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

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

    • seçenekler

      AbortRequestedOptions

    • successCallback

      işlev

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

      () => void

    • errorCallback

      işlev

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

      (error: ProviderError) => void

onAddWatcherRequested

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

Yeni bir dizin izleyicisi ayarlanırken görüntülenir. Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

onCloseFileRequested

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

Daha önce openRequestId ile açılmış bir dosya açılırken öne çıkan değerin kapatılması istenir.

Parametreler

  • geri çağırma

    işlev

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

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

onConfigureRequested

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

fileSystemId için yapılandırma iletişim kutusu gösterilirken talep edildi. İşlenmesi durumunda file_system_provider.configurable manifest seçeneği doğru olarak ayarlanmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

onCopyEntryRequested

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

Bir giriş kopyalanırken (bir dizin istenirse yinelemeli olarak) üretilir. Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

onCreateDirectoryRequested

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

Dizin oluşturma isteğinde bulunulduğunda. Hedef dizin zaten mevcutsa işlem EXISTS hatasıyla başarısız olmalıdır. recursive doğru ise 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. Dosya zaten mevcutsa errorCallback, "EXISTS" hata koduyla çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

onDeleteEntryRequested

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

Bir girişi silme isteğinde bulunulduğunda üretildi. recursive true ise ve giriş bir dizinse, içindeki tüm girişlerin de yinelemeli olarak silinmesi gerekir.

Parametreler

  • geri çağırma

    işlev

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

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

onExecuteActionRequested

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

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

Parametreler

  • geri çağırma

    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 'nı inceleyin.
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

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

Parametreler

  • geri çağırma

    işlev

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

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

onGetMetadataRequested

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

entryPath alanındaki bir dosyanın veya dizinin meta verileri istendiğinde oluşturulur. Meta veriler, successCallback çağrısıyla döndürülmelidir. Hata olması durumunda errorCallback çağrılmalıdır.

Parametreler

onMountRequested

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

Yeni dosya sistemini bağlama iletişim kutusu gösterilirken gösterildi. Uzantı/uygulama bir dosya işleyici ise bu etkinlik işlenmemelidir. Bunun yerine, bir dosya açıldığında yeni dosya sistemlerini eklemek için app.runtime.onLaunched kullanılmalıdır. Birden fazla ekleme için file_system_provider.multiple_mounts manifest seçeneği doğru olarak ayarlanmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

    • successCallback

      işlev

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

      () => void

    • errorCallback

      işlev

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

      (error: ProviderError) => void

onMoveEntryRequested

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

Bir giriş taşınırken (bir dizin istenirse yinelemeli olarak) görüntülenir. Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

onOpenFileRequested

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

filePath itibarıyla bir dosya açılırken öne çıkarıldı. Dosya mevcut değilse işlem başarısız olmalıdır. MountOptions ile tek seferde açılan maksimum dosya sayısı belirtilebilir.

Parametreler

onReadDirectoryRequested

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

directoryPath alanındaki 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 olması durumunda errorCallback çağrılmalıdır.

Parametreler

onReadFileRequested

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

Daha önce openRequestId ile açılmış bir dosyanın içeriği okunurken belirtilen değer istenir. Sonuçlar, successCallback birkaç kez çağrılarak parçalar halinde döndürülmelidir. Hata olması durumunda errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

    • successCallback

      işlev

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

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

      • veri

        DiziArabelleği

      • hasMore

        boolean

    • errorCallback

      işlev

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

      (error: ProviderError) => void

onRemoveWatcherRequested

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

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

Parametreler

  • geri çağırma

    işlev

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

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

onTruncateRequested

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

Dosya istenen uzunlukta olacak şekilde kısaltıldığında "yükseltildi" istenir. Bir hata oluşursa errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

    • 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ı kesilirken yükseltildi. Yanıtta, unmount API yöntemi successCallback ile birlikte çağrılmalıdır. Kaldırma işlemi yapılamıyorsa (ör. bekleyen bir işlem nedeniyle) errorCallback çağrılmalıdır.

Parametreler

  • geri çağırma

    işlev

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

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

    • 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ılırken öne çıkan değer istenir.

Parametreler

  • geri çağırma

    işlev

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

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