Açıklama
Chrome OS'teki dosya yöneticisinden erişilebilen dosya sistemleri oluşturmak için chrome.fileSystemProvider
API'yi kullanın.
İzinler
fileSystemProvider
Kullanılabilirlik
Manifest
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 gibi tanımlanmalıdır:
configurable
(boole) - isteğe bağlı- onConfigureRequested üzerinden yapılandırmanın desteklenip desteklenmediğini belirler. 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 bilgilendirme özelliğinin desteklenip desteklenmediği. Varsayılan olarak: false.
source
("dosya", "cihaz" veya "ağ" sıralaması) - gerekli- Eklenmiş dosya sistemleri için verilerin kaynağı.
Files uygulaması, ilgili kullanıcı arayüzü öğelerini uygun şekilde oluşturmak için yukarıdaki bilgileri kullanır. Örneğin, configurable
politikası doğru değerine ayarlanırsa birimleri yapılandırmak için bir menü öğesi oluşturulur. Benzer şekilde, multiple_mounts
true
olarak ayarlanırsa Files uygulaması, kullanıcı arayüzünden birden fazla ekleme noktası eklemeye izin verir. watchable
değeri false
ise yenile düğmesi oluşturulur. Dosya sistemindeki değişikliklerin anında ve otomatik olarak yansıtılması için mümkünse izleyiciler için destek eklemeniz gerektiğini unutmayın.
Genel bakış
File System Provider API, uzantıların ChromeOS'teki dosya yöneticisinde bulunan sanal dosya sistemlerini desteklemesine olanak tanır. Sıkıştırılmış arşivleri açma ve Drive dışında bir bulut hizmetindeki dosyalara erişme, kullanım alanları arasındadır.
Dosya sistemlerini bağlama
Uzantılar, harici bir kaynaktan (uzak sunucu veya USB cihazı gibi) dosya sistemi içeriklerini sağlayabilir veya giriş olarak yerel bir dosya (ör. arşiv) kullanabilir.
onLaunched
etkinliği uzantılar tarafından kullanılamadığından, dosya işleyici olan (kaynak "file"
) dosya sistemlerini yazmak için sağlayıcının paket uygulama olması gerekir.
Kaynak ağ veya bir cihaz ise onMountRequested etkinliği çağrıldığında dosya sistemi eklenmelidir.
Dosya sistemi verilerinin kaynağı | Giriş noktası |
---|---|
"file" |
Yalnızca paket uygulamalar tarafından 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. Bu, özellikle doğru kimlik bilgilerini ayarlamak üzere içeriği ağ üzerinden sağlayan dosya sistemleri için kullanışlıdır. Bu etkinliğin işlenmesi 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şlatıldıktan veya yeniden başlatıldıktan sonra otomatik olarak yeniden eklenir. Dolayısıyla, bir dosya sistemi sağlanan uzantı tarafından eklendikten sonra, ya uzantı kaldırılana ya da 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ıdır.
Action
Özellikler
-
id
dize
İşlemin tanımlayıcısı. Sık kullanılan işlemler için herhangi bir dize veya
CommonActionId
. -
title
string isteğe bağlı
İşlemin başlığı. Sık kullanılan işlemler için 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özlemleme işleminin tüm alt girişleri yinelemeli olarak içerip içermemesi gerektiği. Yalnızca dizinler için doğru olabilir.
-
requestId
sayı
Bu isteğin benzersiz tanımlayıcısıdır.
Change
Özellikler
-
changeType
Girişte yapılan değişikliğin türü.
-
cloudFileInfo
CloudFileInfo isteğe bağlı
Chrome 125 ve sonraki sürümlerBulut 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
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ıdır.
CloudFileInfo
Özellikler
-
versionTag
string isteğe bağlı
Dosyanın sürümünü temsil eden bir etiket.
CloudIdentifier
Ö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
Sık kullanılan işlemlerin listesi. "SHARE"
, başkalarıyla dosya paylaşmak içindir. Sabitleme için "SAVE_FOR_OFFLINE"
(çevrimdışı erişim için kaydedilir). 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ır.
Enum
"SAVE_FOR_OFFLINE"
"OFFLINE_NOT_NECESSARY"
ConfigureRequestedOptions
Özellikler
-
fileSystemId
dize
Yapılandırılacak dosya sisteminin tanımlayıcısı.
-
requestId
sayı
Bu isteğin benzersiz tanımlayıcısıdır.
CopyEntryRequestedOptions
Özellikler
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
requestId
sayı
Bu isteğin benzersiz tanımlayıcısıdır.
-
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ıdır.
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ıdır.
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ıdır.
EntryMetadata
Özellikler
-
cloudFileInfo
CloudFileInfo isteğe bağlı
Chrome 125 ve sonraki sürümlerTemel bulut dosya sisteminde belirli bir dosyayı tanımlayan bilgiler.
options
içinde istenirse ve dosya bulut depolama alanı tarafından destekleniyorsa sağlanmalıdır. -
cloudIdentifier
CloudIdentifier isteğe bağlı
Chrome 117 ve sonraki sürümlerBu girişin Cloud Storage temsili.
options
içinde istenirse ve dosya bulut depolama alanı tarafından destekleniyorsa sağlanmalıdır. Bulut depolama alanı tarafından desteklenmeyen yerel dosyalar istendiğinde tanımlanmamış olmalıdır. -
isDirectory
boole isteğe bağlı
Bu bir dizinse doğru değerini alır.
options
içinde istenirse sağlanmalıdır. -
mimeType
string 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
string isteğe bağlı
Bu girişin adı (tam yol adı değil). "/" içermemelidir. Kök için alan boş olmalıdır.
options
içinde istenirse sağlanmalıdır. -
beden
numara isteğe bağlı
Bayt cinsinden dosya boyutu.
options
içinde istenirse sağlanmalıdır. -
küçük resim
string isteğe bağlı
Veri URI'si biçiminde, PNG, JPEG veya WEBP biçiminde, 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
Özellikler
-
actionId
dize
Yürütülecek işlemin tanımlayıcısı.
-
entryPaths
dize[]
Chrome 47 ve sonraki sürümlerİşlem için kullanılacak girişlerin yolları grubu.
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
requestId
sayı
Bu isteğin benzersiz tanımlayıcısıdır.
FileSystemInfo
Özellikler
-
displayName
dize
Dosya sistemi için kullanıcıların okuyabileceği bir ad.
-
fileSystemId
dize
Dosya sisteminin tanımlayıcısı.
-
openedFiles
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ümlerDosya sisteminin, dizinleri gözlemlemek için
tag
alanını destekleyip desteklemediği. -
izleyiciler
İzleyici[]
Chrome 45 ve sonraki sürümlerİzleyicilerin 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
Özellikler
-
entryPaths
dize[]
Chrome 47 ve sonraki sürümlerİş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ıdır.
GetMetadataRequestedOptions
Özellikler
-
cloudFileInfo
boolean
Chrome 125 ve sonraki sürümlercloudFileInfo
değeri istenirsetrue
olarak ayarlayın. -
cloudIdentifier
boolean
Chrome 117 ve sonraki sürümlercloudIdentifier
değeri istenirsetrue
olarak ayarlayın. -
entryPath
dize
İlgili meta verilerin getirileceği girişin yolu.
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
isDirectory
boolean
Chrome 49 ve sonraki sürümleris_directory
değeri istenirsetrue
olarak ayarlayın. -
mimeType
boolean
Chrome 49 ve sonraki sürümlermimeType
değeri istenirsetrue
olarak ayarlayın. -
modificationTime
boolean
Chrome 49 ve sonraki sürümlermodificationTime
değeri istenirsetrue
olarak ayarlayın. -
ad
boolean
Chrome 49 ve sonraki sürümlername
değeri istenirsetrue
olarak ayarlayın. -
requestId
sayı
Bu isteğin benzersiz tanımlayıcısıdır.
-
beden
boolean
Chrome 49 ve sonraki sürümlersize
değeri istenirsetrue
olarak ayarlayın. -
küçük resim
boolean
thumbnail
değeri istenirsetrue
olarak ayarlayın.
MountOptions
Özellikler
-
displayName
dize
Dosya sistemi için kullanıcıların okuyabileceği bir ad.
-
fileSystemId
dize
Dosya sisteminin dize tanımlayıcısı. Her uzantı için benzersiz olmalıdır.
-
openedFilesLimit
numara isteğe bağlı
Tek seferde açılabilen maksimum dosya sayısı. Belirtilmezse veya 0 ise sınırlı değildir.
-
inatçı
boole isteğe bağlı
Chrome 64 ve sonraki sürümlerÇerçevenin bir sonraki oturum açma oturumunda dosya sistemini devam ettirip sürdürmeyeceği. True olarak ayarlayın.
-
supportsNotifyTag
boole isteğe bağlı
Chrome 45 ve sonraki sürümlerDosya 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ıdır.
-
sourcePath
dize
Yeni bir yere taşınacak girişin kaynak yolu.
-
targetPath
dize
Kopyalama işleminin hedef yolu.
NotifyOptions
Özellikler
-
changeType
Gözlemlenen girişte gerçekleşen değişikliğin türü. SİLİNDİ ise gözlemlenen giriş, gözlemlenen girişler listesinden otomatik olarak kaldırılır.
-
değişiklikler
Değiştirin[] 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.
-
yinelemeli
boolean
Gözlemlenen girişin modu.
-
etiket
string isteğe bağlı
Bildirim için etiket. Dosya sistemi
supportsNotifyTag
seçeneğiyle eklenmişse gereklidir. Bu işaretin, sistem kapatıldığında 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.
-
mod
Dosyanın okuma mı yoksa yazma için mi açıldığı.
-
openRequestId
sayı
Birbirini izleyen okuma/yazma ve kapatma istekleri tarafından kullanılacak istek kimliği.
OpenFileMode
Dosya açma modu. onOpenFileRequested
tarafından kullanılıyor.
Enum
"READ"
OpenFileRequestedOptions
Özellikler
-
filePath
dize
Açılacak dosyanın yolu.
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
mod
Dosyanın okuma mı yoksa yazma için mi kullanılacağı.
-
requestId
sayı
Birbirini izleyen okuma/yazma ve kapatma istekleri tarafından kullanılacak istek kimliği.
ProviderError
İsteklere yanıt olarak uzantı sağlayarak ve API'nin yöntemleri çağrılırken hata oluşması durumunda kullanılan hata kodları. Başarı için "OK"
kullanılmalıdır.
Enum
"IN_USE":
"EXISTS"
"NOT_FOUND"
"ACCESS_DENIED"
"TOO_MANY_OPENED"
"NO_MEMORY"
"NO_SPACE"
"NOT_A_DIRECTORY"
"INVALID_OPERATION"
"NOT_A_FILE"
"NOT_EMPTY"
"INVALID_URL"
ReadDirectoryRequestedOptions
Özellikler
-
directoryPath
dize
İçeriğin istendiği dizin yolu.
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
isDirectory
boolean
Chrome 49 ve sonraki sürümleris_directory
değeri istenirsetrue
olarak ayarlayın. -
mimeType
boolean
Chrome 49 ve sonraki sürümlermimeType
değeri istenirsetrue
olarak ayarlayın. -
modificationTime
boolean
Chrome 49 ve sonraki sürümlermodificationTime
değeri istenirsetrue
olarak ayarlayın. -
ad
boolean
Chrome 49 ve sonraki sürümlername
değeri istenirsetrue
olarak ayarlayın. -
requestId
sayı
Bu isteğin benzersiz tanımlayıcısıdır.
-
beden
boolean
Chrome 49 ve sonraki sürümlersize
değeri istenirsetrue
olarak ayarlayın. -
küçük resim
boolean
Chrome 49 ve sonraki sürümlerthumbnail
değeri istenirsetrue
olarak ayarlayın.
ReadFileRequestedOptions
Özellikler
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
length
sayı
Döndürülecek bayt sayısı.
-
ofset
sayı
Okumaya başlanacak 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ıdır.
RemoveWatcherRequestedOptions
Özellikler
-
entryPath
dize
İzlenen girişin yolu.
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
yinelemeli
boolean
İzleyicinin modu.
-
requestId
sayı
Bu isteğin benzersiz tanımlayıcısıdır.
TruncateRequestedOptions
Özellikler
-
filePath
dize
Kısaltılacak dosyanın yolu.
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
length
sayı
İşlem tamamlandıktan sonra korunacak bayt sayısı.
-
requestId
sayı
Bu isteğin benzersiz tanımlayıcısıdır.
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ıdır.
Watcher
Özellikler
-
entryPath
dize
Gözlemlenen girişin yolu.
-
lastTag
string isteğe bağlı
İzleyici için son bildirimde kullanılan etiket.
-
yinelemeli
boolean
İzleme işleminin, tüm alt girişleri yinelemeli olarak içerip içermeyeceğini belirleme. Yalnızca dizinler için doğru olabilir.
WriteFileRequestedOptions
Özellikler
-
veri
ArrayBuffer
Dosyaya yazılacak bayt arabelleği.
-
fileSystemId
dize
Bu işlemle ilgili dosya sisteminin tanımlayıcısı.
-
ofset
sayı
Baytların yazılmasına başlanacak 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ıdır.
Yöntemler
get()
chrome.fileSystemProvider.get(
fileSystemId: string,
callback?: function,
)
Geçirilen fileSystemId
özelliğine sahip bir dosya sistemi hakkında bilgi döndürür.
Parametreler
-
fileSystemId
dize
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(fileSystem: FileSystemInfo) => void
-
fileSystem
-
İlerlemeler
-
Promise<FileSystemInfo>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getAll()
chrome.fileSystemProvider.getAll(
callback?: function,
)
Uzantı tarafından eklenen tüm dosya sistemlerini döndürür.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(fileSystems: FileSystemInfo[]) => void
-
fileSystems
-
İlerlemeler
-
Promise<FileSystemInfo[]>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
mount()
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ş dize olamaz. displayName
açıklayıcı olmalıdır, ancak benzersiz olması gerekmez. fileSystemId
boş bir dize olmamalıdır.
Eklenen 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
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
notify()
chrome.fileSystemProvider.notify(
options: NotifyOptions,
callback?: function,
)
recursive
modunda observedPath
konumundaki izlenen dizinde yapılan değişiklikler hakkında bilgi verir. Dosya sistemi supportsNotifyTag
ile eklendiyse tag
sağlanmalı ve son bildirimden bu yana yapılan tüm değişiklikler, sistem kapatılmış olsa bile her zaman bildirilmelidir. Son etiket getAll
ile alınabilir.
Kullanmak için file_system_provider.notify
manifest seçeneğinin doğru değerine ayarlanması gerekir.
tag
değeri, her çağrı için benzersiz olan herhangi bir dize olabilir. Bu nedenle, son kaydedilen bildirim tespit edilebilir. Örneğin, sağlanan uzantı yeniden başlatma sonrasında başlıyorsa ve kaydedilen son 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
yöntemini çağırması gerekir. Boş dize olamaz.
Tüm sağlayıcılar etiket sağlayamaz ancak dosya sisteminde değişiklik günlüğü varsa etiket, değişiklik numarası veya düzeltme numarası olabilir.
Bir üst dizin kaldırılırsa tüm alt girişler de kaldırılır. Bu girişler izlenirse API'ye konuyla ilgili bilgi verilmesi gerektiğini unutmayın. Ayrıca, bir dizin yeniden adlandırılırsa artık orijinal yolları altında herhangi bir giriş olmayacağından tüm alt girişler kaldırılır.
Hata olması durumunda runtime.lastError
yerine ilgili hata kodu ayarlanır.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
unmount()
chrome.fileSystemProvider.unmount(
options: UnmountOptions,
callback?: function,
)
Belirtilen fileSystemId
değerine sahip bir dosya sisteminin bağlantısını keser. Parametre, 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ı durumunda) bağlantıyı kesmeye karar verebilir.
Hata olması durumunda runtime.lastError
ilgili hata koduyla ayarlanır.
Parametreler
-
seçenekler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 96 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
Etkinlikler
onAbortRequested
chrome.fileSystemProvider.onAbortRequested.addListener(
callback: function,
)
operationRequestId
ile bir işlemi iptal etme isteğinde bulunulduğunda belirlenir. 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şlemle ilgili geri çağırma işlevleri, yoksayılacağı için çağrılmamalıdır. errorCallback
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
-
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
-
hata
-
-
onAddWatcherRequested
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
callback: function,
)
Yeni bir dizin izleyicisi ayarlanması istendiğinde yükseltilir. 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
-
seçenekler
-
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
-
hata
-
-
onCloseFileRequested
chrome.fileSystemProvider.onCloseFileRequested.addListener(
callback: function,
)
Daha önce openRequestId
ile açılmış bir dosyayı açmanın kapatılması istendiğinde yükseltilen.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
seçenekler
-
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
-
hata
-
-
onConfigureRequested
chrome.fileSystemProvider.onConfigureRequested.addListener(
callback: function,
)
fileSystemId
için yapılandırma iletişim kutusu gösterildiğinde yükseltilir. İşlenirse file_system_provider.configurable
manifest seçeneği true 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
-
seçenekler
-
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
-
hata
-
-
onCopyEntryRequested
chrome.fileSystemProvider.onCopyEntryRequested.addListener(
callback: function,
)
Bir giriş kopyalanırken gösterilir (bir dizinse yinelenen olarak). 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
-
seçenekler
-
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
-
hata
-
-
onCreateDirectoryRequested
chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
callback: function,
)
Dizin oluşturma istendiğinde yükseltilir. Hedef dizin zaten mevcutsa işlem EXISTS hatasıyla başarısız olmalıdır. recursive
değeri true ise dizin yolundaki eksik tüm dizinlerin oluşturulması gerekir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(options: CreateDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
seçenekler
-
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
-
hata
-
-
onCreateFileRequested
chrome.fileSystemProvider.onCreateFileRequested.addListener(
callback: function,
)
Dosya oluşturma istendiğinde yükseltilir. 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
-
seçenekler
-
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
-
hata
-
-
onDeleteEntryRequested
chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
callback: function,
)
Bir giriş silinmesi istendiğinde gösterilir. recursive
true (doğru) değerine ayarlanırsa ve giriş bir dizinse, içerideki 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
-
seçenekler
-
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
-
hata
-
-
onExecuteActionRequested
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
callback: function,
)
Bir dosya veya dizin grubu için işlem yürütülürken oluşturulan uyarı. İşlem tamamlandıktan sonra successCallback
çağrılmalıdır. Hata 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
-
seçenekler
-
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
-
hata
-
-
onGetActionsRequested
chrome.fileSystemProvider.onGetActionsRequested.addListener(
callback: function,
)
entryPaths
alanındaki bir dosya veya dizin grubu için işlem listesi istendiğinde yükseltilir. Döndürülen tüm işlemler her bir giriş için geçerli olmalıdır. Bu tür bir işlem yoksa boş bir dizi döndürülmelidir. İşlemler successCallback
çağrısıyla 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: GetActionsRequestedOptions, successCallback: function, errorCallback: function) => void
-
seçenekler
-
successCallback
işlev
successCallback
parametresi şu şekilde görünür:(actions: Action[]) => void
-
işlemler
Aksiyon[]
-
-
errorCallback
işlev
errorCallback
parametresi şu şekilde görünür:(error: ProviderError) => void
-
hata
-
-
onGetMetadataRequested
chrome.fileSystemProvider.onGetMetadataRequested.addListener(
callback: function,
)
entryPath
adresindeki bir dosyanın veya dizinin meta verileri istendiğinde yükseltilir. Meta veriler successCallback
çağrısıyla 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: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void
-
seçenekler
-
successCallback
işlev
successCallback
parametresi şu şekilde görünür:(metadata: EntryMetadata) => void
-
metadata
-
-
errorCallback
işlev
errorCallback
parametresi şu şekilde görünür:(error: ProviderError) => void
-
hata
-
-
onMountRequested
chrome.fileSystemProvider.onMountRequested.addListener(
callback: function,
)
Yeni bir dosya sistemi eklemek için iletişim kutusu gösterildiğinde yükseltilir. Uzantı/uygulama bir dosya işleyiciyse bu etkinlik işlenmemelidir. Bunun yerine, bir dosya açıldığında yeni dosya sistemleri eklemek için app.runtime.onLaunched
işlenmelidir. Birden fazla ekleme için file_system_provider.multiple_mounts
manifest seçeneği true 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
-
hata
-
-
onMoveEntryRequested
chrome.fileSystemProvider.onMoveEntryRequested.addListener(
callback: function,
)
Bir giriş taşınırken yükseltilir (bir dizinse yinelemeli). 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
-
seçenekler
-
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
-
hata
-
-
onOpenFileRequested
chrome.fileSystemProvider.onOpenFileRequested.addListener(
callback: function,
)
filePath
konumunda bir dosya açılması istendiğinde yükseltilir. Dosya mevcut değilse işlem başarısız olmalıdır. Aynı anda açılan maksimum dosya sayısı MountOptions
ile belirtilebilir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
seçenekler
-
successCallback
işlev
successCallback
parametresi şu şekilde görünür:(metadata?: EntryMetadata) => void
-
metadata
EntryMetadata isteğe bağlı
-
-
errorCallback
işlev
errorCallback
parametresi şu şekilde görünür:(error: ProviderError) => void
-
hata
-
-
onReadDirectoryRequested
chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
callback: function,
)
directoryPath
adresindeki bir dizinin içeriği istendiğinde yükseltilir. successCallback
birkaç kez çağrılarak sonuçların parçalar halinde 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: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void
-
seçenekler
-
successCallback
işlev
successCallback
parametresi şu şekilde görünür:(entries: EntryMetadata[], hasMore: boolean) => void
-
entries
-
hasMore
boolean
-
-
errorCallback
işlev
errorCallback
parametresi şu şekilde görünür:(error: ProviderError) => void
-
hata
-
-
onReadFileRequested
chrome.fileSystemProvider.onReadFileRequested.addListener(
callback: function,
)
Daha önce openRequestId
ile açılmış bir dosyanın içeriği okunması istendiğinde yükseltilecek. Sonuçların, successCallback
birkaç kez çağrılmasıyla parçalar halinde 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: ReadFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
seçenekler
-
successCallback
işlev
successCallback
parametresi şu şekilde görünür:(data: ArrayBuffer, hasMore: boolean) => void
-
veri
ArrayBuffer
-
hasMore
boolean
-
-
errorCallback
işlev
errorCallback
parametresi şu şekilde görünür:(error: ProviderError) => void
-
hata
-
-
onRemoveWatcherRequested
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
callback: function,
)
İzleyicinin kaldırılması gerektiğinde yükseltilmiş. 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
-
seçenekler
-
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
-
hata
-
-
onTruncateRequested
chrome.fileSystemProvider.onTruncateRequested.addListener(
callback: function,
)
Dosya, istenilen uzunlukta kısaltılırken yükseltilir. 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
-
seçenekler
-
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
-
hata
-
-
onUnmountRequested
chrome.fileSystemProvider.onUnmountRequested.addListener(
callback: function,
)
fileSystemId
tanımlayıcısına sahip dosya sistemi için bağlantıyı keserken yükseltilir. Yanıtta unmount
API yöntemi, successCallback
ile birlikte çağrılmalıdır. Bağlantısı kesilemiyorsa (ör. beklemedeki 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
-
seçenekler
-
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
-
hata
-
-
onWriteFileRequested
chrome.fileSystemProvider.onWriteFileRequested.addListener(
callback: function,
)
Daha önce openRequestId
ile açılmış bir dosyaya içerik yazılması istendiğinde yükseltilecek.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void
-
seçenekler
-
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
-
hata
-
-