項目裡 JSON 的處理頻率非常高,把幾個高頻操作抽成工具函數,之後直接調用即可,能省下不少重複勞動,也便於日後維護。以下四個函數分別負責:格式校驗與歸一化、長度計算、提取全部 key、提取全部 value。
這個函數同時接受 JSON 對象與 JSON 格式字符串,內部先做判斷:是字符串就解析,是對象就直接返回,其餘情況提示並返回 false。
/**
* 檢驗傳入的參數是否為 JSON 對象或 JSON 格式字符串
* 符合條件返回 JSON 對象,否則返回 false
* 注意:'weiyl'、'abcd' 這類普通字符串不是合法 JSON,會拋出異常
*/
function toJson(json) {
var type = typeof json;
// 同時判斷 type 與 json 本身,可排除 null、undefined 與空字符串
if (type == "string" && json) {
return JSON.parse(json);
} else if (type == "object") {
return json;
} else {
alert('你傳入的參數 ' + json + ',不是 JSON 對象或 JSON 格式的字符串');
return false;
}
}
JSON 沒有 length 屬性,只能透過 for...in 遍歷計數。這裡先複用 toJson 做歸一化,再排除不適用的類型,最後統計屬性個數,非法輸入返回 -1。
/**
* 傳入 JSON 對象或 JSON 格式字符串,返回其長度;不合法則返回 -1
*/
function getJsonLen(jsonObj) {
jsonObj = toJson(jsonObj);
var type = typeof jsonObj;
if (type == "boolean" || type == "undefined" ||
type == "number" || type == "function") {
return -1;
}
var len = 0;
for (var item in jsonObj) {
len++;
}
return len;
}
順帶複習 typeof 的六種返回值:"undefined"(未定義)、"boolean"(布爾值)、"string"(字符串)、"number"(數值)、"object"(對象或 null)、"function"(函數)。
/**
* 傳入 JSON 對象或 JSON 字符串,以數組返回所有 key;不合法則返回 -1
*/
function getJsonKey(JsonObj) {
var len = getJsonLen(JsonObj);
if (len == -1) {
return -1;
}
var array = [];
// getJsonLen 內部已完成合法性判斷,這裡可直接遍歷
for (var item in JsonObj) {
array.push(item);
}
return array;
}
/**
* 傳入 JSON 對象或 JSON 字符串,以數組返回所有 value;不合法則返回 -1
*/
function getJsonValue(JsonObj) {
var len = getJsonLen(JsonObj);
if (len == -1) {
return -1;
}
var array = [];
for (var item in JsonObj) {
array.push(JsonObj[item]);
}
return array;
}
第一,層層複用而非重複校驗。getJsonKey 與 getJsonValue 都不再自行判斷格式,而是依賴 getJsonLen 的返回值做前置攔截,讓校驗邏輯集中在一處,後續修改只改一個地方。
第二,用 -1 而非拋異常表達失敗。這樣調用方可以用簡單的數值比較來分支處理,不必到處寫 try...catch;代價是丟失了具體錯誤信息,若用於對外接口,建議改成拋出自定義異常。
還有一個實務提醒:for...in 會枚舉原型鏈上的可枚舉屬性。若數據來源不可控,可在遍歷時加上 hasOwnProperty 判斷,避免混入非自身屬性。