基于HTML5 FileSystem API的使用介紹
我要評論HTML5的強大之一就是允許web程序申請一些臨時或者永久的空間（Quota）在這里可以進行 數(shù)據(jù)的存儲甚至文件的操作。
FileSystem提供了文件夾和文件的創(chuàng)建、移動、刪除等操作，大大方便了數(shù)據(jù)的本地處理， 而且所有的數(shù)據(jù)都是在沙盒(sandboxed)中，不同的web程序不能互相訪問，這就保證了數(shù)據(jù) 的完整和安全。
在CatWrite項目中，運用了HTML5的這個特性進行數(shù)據(jù)的存儲，很是方便，只是目前來說只有 Chrome瀏覽器對FileSystem API支持的比較好，所以只能運行在Chrome瀏覽器中。
在完成這個功能的時候，查閱了很多資料，有一些資料是一年前的，但是隨著瀏覽器版本的 變化，一些代碼已經(jīng)老化，在這里一一總結(jié)和整理。這里只列舉了項目中用到的API，算是 對完成功能的一次梳理。
申請空間
為了進行數(shù)據(jù)的存儲，必須要向瀏覽器進行申請，如果是永久存儲還會向用戶進行詢問，只有 同意后才會繼續(xù)執(zhí)行。
首先必須要聲明想要的權(quán)限。
window.requestFileSystem = window.requestFileSystem || window.webkitRequestFileSystem; //文件系統(tǒng)請求標識
window.resolveLocalFileSystemURL = window.resolveLocalFileSystemURL || window.webkitResolveLocalFileSystemURL; //根據(jù)URL取得文件的讀取權(quán)限
得到系統(tǒng)的權(quán)限后就可以向瀏覽器申請空間
window.requestFileSystem(window.PERSISTENT, //persistent(永久) or temporary(臨時)
1024*1024, //1M
onInitFs, //成功后的回調(diào)函數(shù)
errorHandler); //錯誤后的回調(diào)函數(shù)
回調(diào)函數(shù)
function onInitFs(fs){
fs.root.getDirectory('catwrite_documents', {create: true}, function(dirEntry) {
console.log('You have just created the ' + dirEntry.name + ' directory.');
}, errorHandler);
}
//錯誤回調(diào)
function errorHandler(err){
var msg = 'An error occured: ';
switch (err.code) {
case FileError.NOT_FOUND_ERR:
msg += 'File or directory not found';
break;
case FileError.NOT_READABLE_ERR:
msg += 'File or directory not readable';
break;
case FileError.PATH_EXISTS_ERR:
msg += 'File or directory already exists';
break;
case FileError.TYPE_MISMATCH_ERR:
msg += 'Invalid filetype';
break;
default:
msg += 'Unknown Error';
break;
};
console.log(msg + err);
}
如果成功后悔調(diào)用OnInitFs回調(diào)函數(shù)，在里面用了getDirectory方法用來創(chuàng)建一個文件夾，這下面再說。
但是這是有個問題，這樣做的話每次加載頁面都會申請，這肯定不是我們想要的，我們要 的是在有數(shù)據(jù)的時候就可以讀取數(shù)據(jù)。
判斷是否申請過空間
所以我們需要讀取瀏覽器的數(shù)據(jù)，看看是否已有存儲。這就用到了另一個API：
void queryUsageAndQuota(
in DOMString url,
in EntryCallback successCallback,
in optional ErrorCallback errorCallback
);
這個API可以查詢當前web的空間情況，如果成功的話就會調(diào)用successCallback回調(diào)函數(shù) 并把已用空間和全部空間作為參數(shù)傳入方法中。如果失敗則調(diào)去errorCallback。
window.webkitStorageInfo.queryUsageAndQuota(webkitStorageInfo.PERSISTENT,
function(used, remaining){
if(remaining == ""){
console.log("未申請空間。");
}else{
console.log("已使用空間"+used);
console.log("全部空間"+remaining);
}
},
errorHandler); </p> <p>
我們可以通過判斷remaining參數(shù)來判斷是否有申請空間，如果沒有申請，則返回上一步申請空間。 如果已經(jīng)有空間的話，則需要得到空間的跟文件，這樣才能操作數(shù)據(jù)。
獲取文件入口
FileSystem使用了特殊的文件系統(tǒng)和沙盒模式，在電腦上或者其他web中是無法訪問沙盒中的文件的 ，只能用對應的格式去訪問。
在瀏覽器中輸入：
?filesystem:http://catcoder.com/persistent/
這樣可以訪問catcoder.com這個網(wǎng)站在本機永久數(shù)據(jù)，把persistent換成temporary則是讀取臨時空間。
然后我們就可以通過URL和對應API獲取文件的入口(Lets you look up the entry for a file or directory with a local URL)。
void resolveLocalFileSystemURL(
in DOMString url,
in EntryCallback successCallback,
in optional ErrorCallback errorCallback
);
下面就可以讀取本機存儲的數(shù)據(jù)了
var url = "filesystem:http://" + window.location.host + "/persistent/catwrite_documents/";
window.resolveLocalFileSystemURL(url,function(fileEntry){
console.log(fileEntry);
var dirReader = fileEntry.createReader();
var readEntries = function(){
dirReader.readEntries(function(results){
if(!results.length){
create_file_title("默認文件", "");
console.log("沒有文件！");
}else{
console.log("讀取到" + results.length + "個文件");
for(var i = 0; i < results.length; i++){
console.log(results[i].name);
getFileContentByName(fileEntry, results[i].name);
}
}
},errorHandler);
};
readEntries();
},errorHandler);
相關(guān)文章
- Microdata作為HTML5新增的一個特性，它允許開發(fā)者在HTML文檔中添加更多的語義信息，以便于搜索引擎和瀏覽器更好地理解頁面內(nèi)容，本文將探討HTML5中Microdata的使用方法以及2025-04-21
在HTML語法中，表格主要通過< table >、< tr >和< td >3個標簽構(gòu)成,本文通過實例代碼講解HTML5表格語法格式，感興趣的朋友一起看看吧2025-04-21- 這篇文章主要介紹了HTML5中使用媒體查詢和Flexbox進行響應式布局的方法,簡要介紹了CSS Grid布局的基礎(chǔ)知識和如何實現(xiàn)自動換行的網(wǎng)格布局，感興趣的朋友一起看看吧2025-04-21
基于Canvas的Html5多時區(qū)動態(tài)時鐘實戰(zhàn)代碼
本文介紹了如何使用Canvas在HTML5上實現(xiàn)一個多時區(qū)動態(tài)時鐘的web展示,通過Canvas的API,可以繪制出6個不同城市的時鐘,并且這些時鐘可以動態(tài)轉(zhuǎn)動,每個時鐘上都會標注出對應的2025-03-11HTML5 data-*自定義數(shù)據(jù)屬性的示例代碼
HTML5的自定義數(shù)據(jù)屬性（data-*）提供了一種標準化的方法在HTML元素上存儲額外信息,可以通過JavaScript訪問、修改和在CSS中使用,文章還介紹了高級用法,如存儲JSON數(shù)據(jù)、事2025-03-11- 在HTML5中，下拉框（<select>標簽）作為表單的重要組成部分，為用戶提供了一個從預定義選項中選擇值的方式,本文將深入探討<select>標簽的屬性、樣式，并重點介2025-02-27
本文介紹了HTML5InputDatePicker對象表示HTML``元素,是HTML5中的新對象,介紹了日期、周、月份、時間、日期+時間、本地日期時間等不同類型的日期選擇器，感興趣的朋友一起看2025-02-17
本文介紹了HTML5中的超鏈接、相對路徑和圖片的使用方法,超鏈接可以創(chuàng)建指向另一個文檔或頁面內(nèi)部書簽的鏈接,相對路徑用于在同一服務器內(nèi)部跳轉(zhuǎn)頁面,圖片標簽用于引入外部圖2025-02-17- 本文介紹了HTML5超鏈接的創(chuàng)建方法,包括基本語法、創(chuàng)建圖像超鏈接的邊框去除方法以及錨點鏈接的使用,還討論了超鏈接的四種不同狀態(tài)（link、visited、hover、active）的CSS樣2025-02-17
最近看一些技術(shù)網(wǎng)站發(fā)現(xiàn)了details 標簽的妙用，這個不用js即可實現(xiàn)展開/收縮信息，很方便用來讓用戶先才答案，然后下面點擊再給出答案的效果，這里就為大家簡單介紹一下，2024-11-03
