js如何實現小程序wx.arrayBufferToBase64方法實例

前言

在小程序開發中,需要將接口請求獲得的arrayBuffer數據,轉換為base64格式數據,進行圖片的顯示。

微信小程序提供瞭wx.arrayBufferToBase64方法,但很不幸,這個方法在基礎庫版本 2.4.0 起已廢棄,已不推薦使用。

雖然目前即使小程序基礎庫版本為2.22.0,也能正常使用。但是不確定未來哪天,在更新的基礎庫中,該方法被刪除。這樣就會帶來項目上的隱患。

所以需要自己去實現arrayBuffer轉為base64這一過程。

探索失敗的過程

  • new FileReader()在小程序中無法進行使用。無法使用new FileReader()實例中的readAsDataURL方法將數據轉為base64。如果不熟悉該方法,可以查看FileReader介紹
  • URL.createObjectURL在小程序中無法使用。無法使用該方法將數據轉為在內存中的地址,進而能被image標簽進行引用。如果不熟悉該方法,可以查看URL.createObjectURL講解
  • window.btoa在小程序中無法使用。無法將文本直接轉為base64格式。

好瞭,條條大路都被阻斷瞭。那就該自己鋪路搭橋瞭。

卡殼的arrayBuffer轉base64

問題的起始條件有arrayBuffer數據,期望結果是最終形成base64格式數據。那開始進行求解。

首先我們得來說說arrayBuffer這回事。

在JavaScript中,有一個很常用的引用數據類型Array,你可以在裡面放字符串、數字、對象、佈爾值等等等等。它存放在堆中,可以自由增減。

ArrayBuffer 對象用來表示通用的、固定長度的原始二進制數據緩沖區。它是一個字節數組,通常在其他語言中稱為“byte array”。它的誕生就是為瞭解決一個問題:操作二進制數據。

隻由0和1組成的二進制數據往往是非常巨大的,上千個字節可以說司空見慣,傳統的Array這時候處理起二進制數據起來就顯得非常低效,所以ArrayBuffer出現瞭,它作為一塊專用的內存區域存放在棧中,取數據非常快。

我們現在通過new ArrayBuffer(10)初始化一個buffer實例,看看會得到什麼。

let buffer = new ArrayBuffer(10);
console.log(buffer);

// 在控制臺上顯示如下
ArrayBuffer(10)
byteLength: 10
[[Prototype]]: ArrayBuffer
[[Int8Array]]: Int8Array(10)
[[Uint8Array]]: Uint8Array(10)
[[Int16Array]]: Int16Array(5)
[[ArrayBufferByteLength]]: 10
[[ArrayBufferData]]: 1367

可以看到在ArrayBuffer中,主要存放瞭幾個“視圖”,Int8Array表示8位有符號整數數組,Int16Array表示16位有符號整數數組,Uint8Array則表示8位無符號整數數組。

當然,如果比如說我們想取出Int8Array這個數組來,是不能直接通過buffer.Int8Array來取的。這是因為ArrayBuffer不能直接通過下標去讀寫,我們需要把它轉成一個類型化數組(TypedArray)。

你不能直接操作 ArrayBuffer 的內容,而是要通過類型數組對象或 DataView 對象來操作,它們會將緩沖區中的數據表示為特定的格式,並通過這些格式來讀寫緩沖區的內容。

const myTypedArray = new Uint8Array(buffer)

轉化完之後,我們我們不僅可以通過下標去對類型化數組進行索引,也可以獲取其length,當然TypedArray仍與普通的Array存在細微的區別,那就是假設我們用超出邊界的索引語法去獲取數組元素時,TypedArray並不會去原型鏈中進行查找。

現在我們已經拿到瞭這個類型化數組,是時候把它轉成普通字符串瞭。看看String.fromCharCode這個函數,它接受的參數為一堆代碼單元序列,輸出一個普通字符串。而我們剛剛得到的類型化數組,裡面存放的正是代碼單元。

const str = String.fromCharCode(...myTypedArray)

這裡我們用拓展運算符…把類型數組的代碼單元解出來,一次性轉完,得到一個普通的字符串。

最後,我們需要借助一個window對象的方法,也就是btoa方法,它的作用是:把一個普通字符串編碼成base-64格式的字符串。

上面看似很好,但是在最後一步,btoa,在小程序中是沒有該方法的去使用的。需要自己去實現btoa這個方法。

關鍵點btoa的實現

因為該函數,在瀏覽器中已經實現,所以更多使用在小程序及node環境中。所以總體以module.exports進行方法的輸出,以require形式進行引入。

輸出方法

module.exports = {
  btoa: ...,
  atob: ...
}

引入文件

const { btoa } =  require('./base64')

base64.js

var b64 = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/",
  a256 = '',
  r64 = [256],
  r256 = [256],
  i = 0;

var UTF8 = {

  /**
   * Encode multi-byte Unicode string into utf-8 multiple single-byte characters
   * (BMP / basic multilingual plane only)
   *
   * Chars in range U+0080 - U+07FF are encoded in 2 chars, U+0800 - U+FFFF in 3 chars
   *
   * @param {String} strUni Unicode string to be encoded as UTF-8
   * @returns {String} encoded string
   */
  encode: function (strUni) {
    // use regular expressions & String.replace callback function for better efficiency
    // than procedural approaches
    var strUtf = strUni.replace(/[\u0080-\u07ff]/g, // U+0080 - U+07FF => 2 bytes 110yyyyy, 10zzzzzz
      function (c) {
        var cc = c.charCodeAt(0);
        return String.fromCharCode(0xc0 | cc >> 6, 0x80 | cc & 0x3f);
      })
      .replace(/[\u0800-\uffff]/g, // U+0800 - U+FFFF => 3 bytes 1110xxxx, 10yyyyyy, 10zzzzzz
        function (c) {
          var cc = c.charCodeAt(0);
          return String.fromCharCode(0xe0 | cc >> 12, 0x80 | cc >> 6 & 0x3F, 0x80 | cc & 0x3f);
        });
    return strUtf;
  },

  /**
   * Decode utf-8 encoded string back into multi-byte Unicode characters
   *
   * @param {String} strUtf UTF-8 string to be decoded back to Unicode
   * @returns {String} decoded string
   */
  decode: function (strUtf) {
    // note: decode 3-byte chars first as decoded 2-byte strings could appear to be 3-byte char!
    var strUni = strUtf.replace(/[\u00e0-\u00ef][\u0080-\u00bf][\u0080-\u00bf]/g, // 3-byte chars
      function (c) { // (note parentheses for precence)
        var cc = ((c.charCodeAt(0) & 0x0f) << 12) | ((c.charCodeAt(1) & 0x3f) << 6) | (c.charCodeAt(2) & 0x3f);
        return String.fromCharCode(cc);
      })
      .replace(/[\u00c0-\u00df][\u0080-\u00bf]/g, // 2-byte chars
        function (c) { // (note parentheses for precence)
          var cc = (c.charCodeAt(0) & 0x1f) << 6 | c.charCodeAt(1) & 0x3f;
          return String.fromCharCode(cc);
        });
    return strUni;
  }
};

while (i < 256) {
  var c = String.fromCharCode(i);
  a256 += c;
  r256[i] = i;
  r64[i] = b64.indexOf(c);
  ++i;
}

function code(s, discard, alpha, beta, w1, w2) {
  s = String(s);
  var buffer = 0,
    i = 0,
    length = s.length,
    result = '',
    bitsInBuffer = 0;

  while (i < length) {
    var c = s.charCodeAt(i);
    c = c < 256 ? alpha[c] : -1;

    buffer = (buffer << w1) + c;
    bitsInBuffer += w1;

    while (bitsInBuffer >= w2) {
      bitsInBuffer -= w2;
      var tmp = buffer >> bitsInBuffer;
      result += beta.charAt(tmp);
      buffer ^= tmp << bitsInBuffer;
    }
    ++i;
  }
  if (!discard && bitsInBuffer > 0) result += beta.charAt(buffer << (w2 - bitsInBuffer));
  return result;
}

var Plugin = function (dir, input, encode) {
  return input ? Plugin[dir](input, encode) : dir ? null : this;
};

Plugin.btoa = Plugin.encode = function (plain, utf8encode) {
  plain = Plugin.raw === false || Plugin.utf8encode || utf8encode ? UTF8.encode(plain) : plain;
  plain = code(plain, false, r256, b64, 8, 6);
  return plain + '===='.slice((plain.length % 4) || 4);
};

Plugin.atob = Plugin.decode = function (coded, utf8decode) {
  coded = coded.replace(/[^A-Za-z0-9\+\/\=]/g, "");
  coded = String(coded).split('=');
  var i = coded.length;
  do {
    --i;
    coded[i] = code(coded[i], true, r64, a256, 6, 8);
  } while (i > 0);
  coded = coded.join('');
  return Plugin.raw === false || Plugin.utf8decode || utf8decode ? UTF8.decode(coded) : coded;
};
module.exports = {
  btoa: Plugin.btoa,
  atob: Plugin.atob
}

修成正果

有時候後臺把圖片資源通過arrayBuffer傳給前端,這時候為瞭能正常顯示,我們還需要在轉化的base64字符串前面拼接上data:image/jpeg;base64,

所以我們整理一下,可以得出這樣一個函數:

const { btoa } =  require('./base64')
const arrayBufferToBase64Img = (buffer) => {
  const str = String.fromCharCode(...new Uint8Array(buffer));
  return `data:image/jpeg;base64,${btoa(str)}`;
}

整個流程如下:

得到一個ArrayBuffer —> 轉成類型化數組以正常讀取(Uint8Array) –> 轉成普通字符串(String.fromCharCode) –> 轉成base64字符串(btoa)

總結

到此這篇關於js如何實現小程序wx.arrayBufferToBase64方法實例的文章就介紹到這瞭,更多相關js實現小程序wx.arrayBufferToBase64內容請搜索WalkonNet以前的文章或繼續瀏覽下面的相關文章希望大傢以後多多支持WalkonNet!

推薦閱讀: