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
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
Ö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
Özellikler
-
volumeId
dize
-
yazılabilir
boolean
VolumeListChangedEvent
Özellikler
-
ciltler
Cilt[]
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()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getVolumeList()
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
İlerlemeler
-
Söz<Hacim[] | undefined>
Chrome 117 ve sonraki sürümlerVaatler 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()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
isWritableEntry()
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ümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
requestFileSystem()
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
-
seçenekler
-
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ümlerVaatler 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.fileSystem.onVolumeListChanged.addListener(
callback: function,
)
Kullanılabilir birimlerin listesi değiştirildiğinde çağrılır.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(event: VolumeListChangedEvent) => void
-
event
-