JavaScript 天生擅長字串,卻天生不擅長二進位。原因不難理解:它最初是為了解決 HTML 文件操作而設計的,因此語言裡既沒有 byte 型別,也沒有結構化型別,更沒有位元組陣列——就只有數字和字串。
Node 建立在 JavaScript 之上,處理 HTTP 這類文字協定自然游刃有餘。但一旦你要連資料庫、處理圖片、接檔案上傳,只靠字串硬撐就會變得非常痛苦。早期 Node 把位元組編碼成文字字元來繞路,實踐證明這條路走不通:浪費資源、速度慢、不夠靈活,維護起來更是惡夢。
於是 Node 提供了 Buffer 這個二進位緩衝實作。這個「偽類別」包裝了一整套處理原始位元組的 API,把原本繁瑣的任務簡化了不少。緩衝的長度就是位元組數,你可以隨機讀寫其中任一個位置。
值得牢記的是:Buffer 所佔用的記憶體並不配置在 JavaScript VM 的記憶體堆上,因此不受垃圾回收機制管理,而是落在一塊固定且不會被搬移的位址上。這也省下了因緩衝內容搬移而產生的 CPU 消耗。
用一個 UTF-8 字串就能建立緩衝:
var buf = new Buffer('Hello World!');
也可以指定編碼:
var buf = new Buffer('8b76fde713ce', 'base64');
常見的編碼標識有:
若沒有初始資料,也可以直接指定容量建立一個空緩衝:
var buf = new Buffer(1024); // 建立一個 1024 位元組的緩衝
拿到緩衝物件後,用 [] 運算子就能存取單一位元組:
var buf = new Buffer('my buffer content');
// 存取緩衝中的第 10 個位元組
console.log(buf[10]); // -> 99
但這裡有個陷阱:用容量大小建立的緩衝,內容並不會被清零,而是殘留的隨機資料。
var buf = new Buffer(1024);
console.log(buf[100]); // -> 某個隨機值
寫入同樣直覺:
buf[99] = 125; // 把第 100 個位元組設為 125
另外,某些看起來「不合理」的賦值其實不會丟錯誤,而是靜靜地做些轉換:
這些「安靜的失敗」是 bug 的溫床,處理外部資料時最好自己先驗證範圍。
用 length 屬性可以取得長度:
var buf = new Buffer(100);
console.log(buf.length); // -> 100
有了長度就能迭代整個緩衝:
var buf = new Buffer(100);
for (var i = 0; i < buf.length; i++) {
buf[i] = i;
}
上面這段建立了一個 100 位元組的緩衝,並把每個位置依序填成 0 到 99。
若你想從既有緩衝中取出一段,可以用 slice 指定起訖位置:
var buffer = new Buffer("this is the content of my buffer");
var smallerBuffer = buffer.slice(8, 19);
console.log(smallerBuffer.toString()); // -> "the content"
關鍵在於:slice 不會配置或複製任何新記憶體。新緩衝共用父緩衝的記憶體,本質上只是父緩衝某段範圍的參照。這帶來兩個後果。
第一,父子緩衝是不同的 JavaScript 物件,你修改父緩衝的內容,子緩衝跟著變——這件事很違反直覺,容易埋雷。
第二,只要子緩衝還活著,父緩衝物件就不會被回收。若爸媽緩衝很大而你只留了一小塊,記憶體就這樣被釘住了,養成memory leak。
如果你確實需要獨立的一份資料,改用 copy,細節見下。
copy 可以把一段內容真正複製到另一個緩衝:
var buffer1 = new Buffer("this is the content of my buffer");
var buffer2 = new Buffer(11);
var targetStart = 0;
var sourceStart = 8;
var sourceEnd = 19;
buffer1.copy(buffer2, targetStart, sourceStart, sourceEnd);
console.log(buffer2.toString()); // -> "the content"
這段程式把來源緩衝的第 9 到 20 個位元組,複製到目標緩衝的起始位置。兩個緩衝自此各自獨立。
把緩衝轉成 UTF-8 字串只需要:
var str = buf.toString();
指定編碼參數就能解成其他格式,例如 base64:
var b64Str = buf.toString("base64");
靠著這個方法,UTF-8 轉 base64 也就是兩步而已:
var utf8String = 'my string';
var buf = new Buffer(utf8String);
var base64String = buf.toString('base64');
只要你的應用會碰到二進位資料,Buffer 就是必備工具。它封裝了對連續記憶體區塊的操作,讓你能在兩個緩衝之間切分或複製資料,也能在緩衝與特定編碼字串之間雙向轉換,逐位元組地存取與處理。
實務上有三件事值得養成習慣:建立緩衝後先想清楚內容是否需要初始化、用 slice 時留意共用記憶體帶來的耦合與洩漏風險、寫入前先檢查範圍以免資料被靜默截斷。