chrome.fileSystem

Açıklama

Kullanıcının yerel dosya sisteminde dosya oluşturmak, okumak, sistemde gezinmek ve bu sisteme yazmak için chrome.fileSystem API'yi kullanın. Bu API ile Chrome Uygulamaları, kullanıcı tarafından seçilen bir konumu okuyabilir ve 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 'nı inceleyin.

Türler

AcceptOption

Özellikler

  • açıklama

    dize isteğe bağlı

    Bu, bu seçeneğin isteğe bağlı metin açıklamasıdır. Açıklama mevcut değilse otomatik olarak bir açıklama oluşturulur; genellikle geçerli uzantıların genişletilmiş bir listesini içerir (ör. "text/html", "*.html, *.htm" öğesine 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/*" olur. 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ı için isteğe bağlı kabul seçenekleri listesi. Her seçenek, son kullanıcıya benzersiz bir grup olarak sunulur.

  • acceptsAllTypes

    boole isteğe bağlı

    Kabul eden bağımsız değişkende belirtilen seçeneklere ek olarak, tüm dosya türlerinin kabul edilip edilmeyeceğini belirtir. Varsayılan değer, doğru değeridir. Kabul edilir alanı ayarlanmamışsa veya geçerli giriş içermiyorsa bu her zaman "doğru" olarak sıfırlanır.

  • acceptsMultiple

    boole isteğe bağlı

    Birden fazla dosyanın kabul edilip edilmeyeceğini belirler. Bu, yalnızca openFile ve openWritableFile için desteklenir. Doğru değerine ayarlanırsa selectEntry için geri çağırma, giriş listesiyle birlikte çağrılır. Aksi takdirde tek bir Giriş ile çağrılır.

  • suggestedName

    dize isteğe bağlı

    Kullanıcıya okuması veya yazması için varsayılan ad olarak 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 "openFile"dır.

ChooseEntryType

Enum

"openFile"
Kullanıcıdan mevcut bir dosyayı açmasını ister ve başarılı olursa bir Dosya Girişi döndürür. Chrome 31 sürümünden itibaren, uygulamada "yazma" özelliği varsa dosya girişi yazılabilir “fileSystem” altında izne sahip olmalıdır; Aksi takdirde, Dosya Girişi salt okunur olur.

"openWritableFile"
Kullanıcıdan mevcut bir dosyayı açmasını ister ve başarılı olursa yazılabilir bir Dosya Girişi döndürür. Uygulamada "yazma" özelliği yoksa bu türü kullanan çağrılar, çalışma zamanı hatasıyla başarısız olur ("fileSystem" altında).

"saveFile"
Kullanıcıdan mevcut bir dosyayı veya yeni bir dosyayı açmasını ister ve başarılı olursa yazılabilir bir Dosya Girişi döndürür. Uygulamada "yazma" özelliği yoksa bu türü kullanan çağrılar, çalışma zamanı hatasıyla başarısız olur ("fileSystem" altında).

"openDirectory"
Kullanıcıdan bir dizini açmasını ister ve işlemin başarılı olması durumunda bir DirectoryEntry (Dizin Girişi) döndürür. Uygulamada "dizin" yoksa bu türü kullanan çağrılar, çalışma zamanı hatasıyla başarısız olur. izni gerekir. Uygulamada "yazma" özelliği varsa "fileSystem" altındaki iznine geri dönerseniz, döndürülen DirectoryEntry yazılabilir olur; Aksi takdirde salt okunur olur. Chrome 31'deki yenilikler.

RequestFileSystemOptions

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

Özellikler

  • volumeId

    dize

    İstenen birimin kimliği.

  • yazılabilir

    boole isteğe bağlı

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

Volume

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

Özellikler

  • volumeId

    dize

  • yazılabilir

    boolean

VolumeListChangedEvent

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

Özellikler

Yöntemler

chooseEntry()

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

Kullanıcıdan 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

      Dosya Girişi[] isteğe bağlı

getDisplayPath()

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

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

Parametreler

  • giriş

    Giriş

  • geri çağırma

    işlev isteğe bağlı

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

    (displayPath: string) => void

    • displayPath

      dize

İadeler

  • Promise<dize>

    Chrome 117 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.

getVolumeList()

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

requestFileSystem() için kullanılabilir ciltlerin 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ımsız olarak ayarlanacak ve chrome.runtime.lastError ayarlanacaktır.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (volumes?: Volume[]) => void

    • cilt

      Hacim[] isteğe bağlı

İadeler

  • Promise&lt;Volume[] | tanımlanmadı>

    Chrome 117 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.

getWritableEntry()

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

Başka bir Girişten yazılabilir giriş alın. Uygulamada "yazma" özelliği yoksa bu çağrı, çalışma zamanı hatasıyla başarısız olur. izni gerekir. Giriş bir DirectoryEntry ise, uygulamada "directory" öğesi yoksa bu çağrı başarısız olacaktır izni gerekir.

Parametreler

  • giriş

    Giriş

  • geri çağırma

    işlev

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

    (entry: Entry) => void

    • giriş

      Giriş

isRestorable()

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

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

Parametreler

  • id

    dize

  • geri çağırma

    işlev isteğe bağlı

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

    (isRestorable: boolean) => void

    • isRestorable

      boolean

İadeler

  • Promise&lt;boolean&gt;

    Chrome 117 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.

isWritableEntry()

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

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

Parametreler

  • giriş

    Giriş

  • geri çağırma

    işlev isteğe bağlı

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

    (isWritable: boolean) => void

    • isWritable

      boolean

İadeler

  • Promise&lt;boolean&gt;

    Chrome 117 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.

requestFileSystem()

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

options.volumeId ile temsil edilen bir birim için bir dosya sistemine erişim isteğinde bulunur. options.writable doğru değerine ayarlanırsa dosya sistemi yazılabilir. Aksi takdirde salt okunur olur. writable seçeneği, manifest'te "fileSystem": {"write"} iznini gerektirir. Yalnızca kiosk oturumunda çalışan kiosk uygulamaları tarafından kullanılabilir. Manuel olarak başlatılan kiosk modu için etkin uygulama penceresinin üst kısmında bir onay iletişim kutusu gösterilir. Hata olması durumunda fileSystem tanımsız olarak ayarlanacak ve chrome.runtime.lastError ayarlanacaktır.

Parametreler

  • geri çağırma

    işlev isteğe bağlı

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

    (fileSystem?: FileSystem) => void

    • fileSystem

      Dosya Sistemi isteğe bağlı

İadeler

  • Promise&lt;FileSystem | tanımlanmadı>

    Chrome 117 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.

restoreEntry()

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

Geri yüklenebiliyorsa belirtilen kimliğe sahip dosya girişini döndürür. Aksi takdirde bu çağrı, çalışma zamanı hatası ile 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 elde etmek için geri yüklemek üzere aktarılabilecek bir kimlik döndürür. Yalnızca en son kullanılan 500 giriş saklanır. Burada, keepEntry ve geri girdi girdisi çağrılarının kullanım olarak sayılması gerekir. Uygulamada "retainEntries" etiketi varsa izni varsa girişler süresiz olarak saklanır. Aksi takdirde, girişler yalnızca uygulama çalışırken ve yeniden başlatma sırasında saklanır.

Parametreler

  • giriş

    Giriş

İadeler

  • dize

Etkinlikler

onVolumeListChanged

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

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

Parametreler