chrome.fileSystem

Açıklama

Kullanıcının yerel dosya sisteminde dosya oluşturmak, bu sistemde gezinmek ve dosyayı okumak için chrome.fileSystem API'yi kullanın. Bu API ile Chrome Uygulamaları kullanıcı tarafından seçilen bir konumu okuyabilir ve bu konuma yazabilir. Örneğin, bir metin düzenleyici uygulaması yerel dokümanları okuyup yazmak için API'yi kullanabilir. Tüm hatalar chrome.runtime.lastError aracılığıyla bildirilir.

İzinler

fileSystem

Kullanılabilirlik

Yalnızca ön plan

Türler

AcceptOption

Özellikler

  • açıklama

    string isteğe bağlı

    Bu, bu seçenek için isteğe bağlı metin açıklamasıdır. Açıklama yoksa otomatik olarak oluşturulur.Açıklama, genellikle geçerli uzantıların genişletilmiş bir listesini içerir (ör. "metin/html" ifadesi "*.html, *.htm" şeklinde genişleyebilir).

  • uzantılar

    string[] isteğe bağlı

    Kabul edilecek uzantılar, ör. "jpg", "gif", "crx".

  • mimeTypes

    string[] isteğe bağlı

    Kabul edilecek mime türleri, ör. "image/jpeg" veya "audio/*". mimeType'lardan veya uzantılardan biri, en az bir geçerli öğe içermelidir.

ChooseEntryOptions

Özellikler

  • kabul eder

    AcceptOption[] isteğe bağlı

    Bu dosya açıcısı için isteğe bağlı kabul etme seçenekleri listesi. Her seçenek, son kullanıcıya benzersiz bir grup olarak sunulur.

  • acceptsAllTypes

    boole isteğe bağlı

    Kabul edilir bağımsız değişkeninde belirtilen seçeneklere ek olarak, tüm dosya türlerinin kabul edilip edilmeyeceğini belirler. Varsayılan, doğru değeridir. Kabul edilir alanı ayarlanmazsa veya geçerli bir giriş içermiyorsa bu alan her zaman doğru değerine sıfırlanır.

  • acceptsMultiple

    boole isteğe bağlı

    Birden fazla dosya kabul edip etmeyeceğinizi belirler. Bu yalnızca openFile ve openWritableFile için desteklenir. Bu değer doğru değerine ayarlanırsa selectEntry için geri çağırma, bir giriş listesiyle çağrılır. Aksi takdirde tek bir Giriş ile çağrılır.

  • suggestedName

    string isteğe bağlı

    Okuma veya yazma işlemi için varsayılan ad olarak kullanıcıya sunulacak önerilen dosya adı. Bu işlem isteğe bağlıdır.

  • tür

    ChooseEntryType isteğe bağlı

    Gösterilecek istemin türü. Varsayılan değer "openFile"dır.

ChooseEntryType

Enum

"openFile"
Kullanıcıdan mevcut bir dosyayı açmasını ister ve başarılı olduğunda Dosya Girişi döndürür. Chrome 31 sürümünden itibaren, uygulamanın "fileSystem" altında "yazma" izni olması halinde FileEntry yazılabilir, aksi takdirde FileEntry salt okunur hale gelir.

"openWritableFile"
Kullanıcıdan mevcut bir dosyayı açmasını ister ve başarılı olduğunda yazılabilir bir FileEntry döndürür. Uygulamanın "fileSystem" altında "yazma" izni yoksa bu türü kullanan çağrılar, çalışma zamanı hatasıyla başarısız olur.

"saveFile"
Kullanıcıdan mevcut bir dosyayı veya yeni bir dosyayı açmasını ister ve başarılı olduğunda yazılabilir bir FileEntry döndürür. Uygulamanın "fileSystem" altında "yazma" izni yoksa bu türü kullanan çağrılar, çalışma zamanı hatasıyla başarısız olur.

"openDirectory"
Kullanıcıdan bir dizin açmasını ister ve başarılı olduğunda DirectoryEntry döndürür. Uygulamanın "fileSystem" altında "dizin" izni yoksa bu türü kullanan çağrılar, çalışma zamanı hatasıyla başarısız olur. Uygulamanın "fileSystem" altında "yazma" izni varsa döndürülen DirectoryEntry öğesi yazılabilir, aksi takdirde salt okunur olur. Chrome 31'deki yenilikler.

RequestFileSystemOptions

Chrome 44 ve sonraki sürümler

Özellikler

  • volumeId

    dize

    İstenen birimin kimliği.

  • yazılabilir

    boole isteğe bağlı

    İstenen dosya sisteminin yazılabilir olup olmayacağı. Varsayılan, salt okunurdur.

Volume

Chrome 44 ve sonraki sürümler

Özellikler

  • volumeId

    dize

  • yazılabilir

    boolean

VolumeListChangedEvent

Chrome 44 ve sonraki sürümler

Özellikler

Yöntemler

chooseEntry()

chrome.fileSystem.chooseEntry(
  options?: ChooseEntryOptions,
  callback: function,
)

Kullanıcıdan bir dosya veya dizin seçmesini isteyin.

Parametreler

  • seçenekler

    ChooseEntryOptions isteğe bağlı

  • geri çağırma

    işlev

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

    (entry?: Entry,fileEntries?: FileEntry[])=>void

    • giriş

      Giriş isteğe bağlı

    • fileEntries

      FileEntry[] isteğe bağlı

getDisplayPath()

Söz 
chrome.fileSystem.getDisplayPath(
  entry: Entry,
  callback?: function,
)

Bir Giriş nesnesinin görünen yolunu alma. Görünen yol, yerel dosya sistemindeki dosya veya dizinin tam yolunu temel alır, ancak görüntüleme amacıyla daha okunabilir hale getirilebilir.

Parametreler

  • giriş

    Giriş

  • geri çağırma

    Functions (isteğe bağlı)

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

    (displayPath: string)=>void

    • displayPath

      dize

İlerlemeler

  • Söz<dize>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getVolumeList()

Söz Chrome 44 ve sonraki sürümleri 
chrome.fileSystem.getVolumeList(
  callback?: function,
)

requestFileSystem() için kullanılabilir birimlerin listesini döndürür. "fileSystem": {"requestFileSystem"} manifest izni gerekli. Yalnızca kiosk oturumunda çalışan kiosk uygulamaları tarafından kullanılabilir. Hata olması durumunda volumes tanımlanmayacak ve chrome.runtime.lastError ayarlanacak.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

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

    (volumes?: Volume[])=>void

    • ciltler

      Hacim[] isteğe bağlı

İlerlemeler

  • Söz<Ses[]|undefined>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

getWritableEntry()

chrome.fileSystem.getWritableEntry(
  entry: Entry,
  callback: function,
)

Başka bir Girişten yazılabilir bir Giriş alın. Uygulamanın "fileSystem" altında "yazma" izni yoksa bu çağrı, çalışma zamanı hatası vererek başarısız olur. Giriş bir DirectoryEntry ise, uygulamanın "fileSystem" altında "directory" izni yoksa bu çağrı başarısız olur.

Parametreler

  • giriş

    Giriş

  • geri çağırma

    işlev

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

    (entry: Entry)=>void

    • giriş

      Giriş

isRestorable()

Söz 
chrome.fileSystem.isRestorable(
  id: string,
  callback?: function,
)

Uygulamanın belirtilen kimlikle girişi geri yükleme izni olup olmadığını döndürür.

Parametreler

  • id

    dize

  • geri çağırma

    Functions (isteğe bağlı)

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

    (isRestorable: boolean)=>void

    • isRestorable

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

isWritableEntry()

Söz 
chrome.fileSystem.isWritableEntry(
  entry: Entry,
  callback?: function,
)

Bu Girişin yazılabilir olup olmadığını belirler.

Parametreler

  • giriş

    Giriş

  • geri çağırma

    Functions (isteğe bağlı)

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

    (isWritable: boolean)=>void

    • isWritable

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

requestFileSystem()

Söz Chrome 44 ve sonraki sürümleri 
chrome.fileSystem.requestFileSystem(
  options: RequestFileSystemOptions,
  callback?: function,
)

options.volumeId ile temsil edilen bir birim için dosya sistemine erişim ister. options.writable true (doğru) değerine ayarlanırsa dosya sistemi yazılabilir olur. Aksi takdirde, salt okunur olur. writable seçeneği, manifest dosyasında "fileSystem": {"write"} iznini gerektirir. Yalnızca kiosk oturumunda çalışan kiosk uygulamaları tarafından kullanılabilir. Manuel başlatma kiosk modunda etkin uygulama penceresinin üst kısmında bir onay iletişim kutusu gösterilir. Hata olması durumunda fileSystem tanımlanmayacak ve chrome.runtime.lastError ayarlanacak.

Parametreler

  • geri çağırma

    Functions (isteğe bağlı)

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

    (fileSystem?: FileSystem)=>void

    • fileSystem

      Dosya Sistemi isteğe bağlı

İlerlemeler

  • Promise<FileSystem|undefined>

    Chrome 117 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.

restoreEntry()

chrome.fileSystem.restoreEntry(
  id: string,
  callback: function,
)

Belirtilen kimlikle geri yüklenebilecek dosya girişini döndürür. Aksi takdirde bu çağrı, bir çalışma zamanı hatası vererek başarısız olur.

Parametreler

  • id

    dize

  • geri çağırma

    işlev

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

    (entry: Entry)=>void

    • giriş

      Giriş

retainEntry()

chrome.fileSystem.retainEntry(
  entry: Entry,
)

Belirli bir dosya girişine yeniden erişim kazanmak için restoreEntry öğesine geçirilebilecek bir kimlik döndürür. Yalnızca en son kullanılan 500 giriş saklanır. Burada, "Giriş"i saklamak ve "RestoreEntry" için yapılan çağrılar kullanım olarak sayılır. Uygulamanın "fileSystem" altında "retainEntries" izni varsa girişler süresiz olarak saklanır. Aksi takdirde, girişler yalnızca uygulama çalışırken ve yeniden başlatıldığında tutulur.

Parametreler

  • giriş

    Giriş

İlerlemeler

  • dize

Etkinlikler

onVolumeListChanged

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

Kullanılabilir birimlerin listesi değiştirildiğinde çağrılır.

Parametreler