321

I need an efficient (read native) way to convert an ArrayBuffer to a base64 string which needs to be used on a multipart post.

1
  • if you need it in a multipart/form-data then create a FormData and a Blob from ArrayBuffer, append the blob to formdata and post binary data instead of base64.
    – Endless
    Sep 27 at 15:42

19 Answers 19

341
function _arrayBufferToBase64( buffer ) {
    var binary = '';
    var bytes = new Uint8Array( buffer );
    var len = bytes.byteLength;
    for (var i = 0; i < len; i++) {
        binary += String.fromCharCode( bytes[ i ] );
    }
    return window.btoa( binary );
}

but, non-native implementations are faster e.g. https://gist.github.com/958841 see http://jsperf.com/encoding-xhr-image-data/6

Updated benchmarks: https://jsben.ch/wnaZC

15
  • 17
    I tried the non-native implementation from the link and it took 1min and half to convert a 1M size buffer while the loop code above only took 1sec.
    – cshu
    Jun 28, 2013 at 18:12
  • 4
    I like the simplicity of this approach, but all that string concatenation can be costly. It looks like building an array of the characters and join()ing them at the end is significantly faster on Firefox, IE, and Safari (but quite a lot slower on Chrome): jsperf.com/tobase64-implementations
    – JLRishe
    May 14, 2014 at 9:30
  • 1
    I am trying 50mb pdf file upload using angualrjs and webapi2. I am using above line code , after upload file, the page got crashed and hanged . Below line of code ,I was used but getting null value in webapi method. "var base64String = btoa(String.fromCharCode.apply(null, new Uint8Array(arrayBuffer)));" please suggest any idea ... Nov 14, 2016 at 9:14
  • 4
    I'm wondering why everyone is avoiding the native buffer toString('base64') method. Feb 20, 2020 at 13:56
  • 16
    @JoãoEduardoSoareseSilva because not everyone is using Node - Node's Buffer doesn't exist in the browser.
    – Andrew
    Apr 5, 2021 at 23:03
182

This works fine for me:

var base64String = btoa(String.fromCharCode.apply(null, new Uint8Array(arrayBuffer)));

In ES6, the syntax is a little simpler:

const base64String = btoa(String.fromCharCode(...new Uint8Array(arrayBuffer)));

As pointed out in the comments, this method may result in a runtime error in some browsers when the ArrayBuffer is large. The exact size limit is implementation dependent in any case.

11
  • 60
    I like this method better for conciseness, but get a "maximum call stack size exceeded error". The loop technique above gets around that.
    – Jason
    Sep 7, 2012 at 12:26
  • 15
    I'm also getting a stack size error, so I used mobz's answer and it worked great. Sep 3, 2013 at 1:34
  • 26
    It didn't work for large buffers. Slight modification to make it work: btoa([].reduce.call(new Uint8Array(bufferArray),function(p,c){return p+String.fromCharCode(c)},'')) Nov 12, 2015 at 22:06
  • 2
    I am trying 50mb pdf file upload using angualrjs and webapi2. I am using above line code , after upload file, the page got crashed and hanged . Below line of code ,I was used but getting null value in webapi method. "var base64String = btoa(String.fromCharCode.apply(null, new Uint8Array(arrayBuffer)));" please suggest any idea ... Nov 14, 2016 at 11:53
  • 9
    @Kugel btoa is safe for characters in the code range 0-255, as this is here the case (Think about the 8 in Uint8Array).
    – GOTO 0
    Aug 24, 2017 at 6:59
59

For those who like it short, here's an other one using Array.reduce which will not cause stack overflow:

var base64 = btoa(
  new Uint8Array(arrayBuffer)
    .reduce((data, byte) => data + String.fromCharCode(byte), '')
);
4
  • 10
    Not sure if that's really sexy. After all, you're creating <amount of Bytes in the buffer> new strings.
    – Neonit
    Mar 28, 2018 at 7:22
  • 1
    How about btoa(new Uint8Array(arraybuffer).reduce((data,byte)=>(data.push(String.fromCharCode(byte)),data),[]).join(''))?
    – Roy Tinker
    Sep 12, 2018 at 0:30
  • 2
    Another alternative: btoa(Array.from(new Uint8Array(arraybuffer)).map(b => String.fromCharCode(b)).join('')). Sep 19, 2020 at 7:00
  • 1
    Failed to execute 'btoa' on 'Window': The string to be encoded contains characters outside of the Latin1 range
    – RouR
    Sep 24, 2021 at 14:22
44

There is another asynchronous way use Blob and FileReader.

I didn't test the performance. But it is a different way of thinking.

function arrayBufferToBase64( buffer, callback ) {
    var blob = new Blob([buffer],{type:'application/octet-binary'});
    var reader = new FileReader();
    reader.onload = function(evt){
        var dataurl = evt.target.result;
        callback(dataurl.substr(dataurl.indexOf(',')+1));
    };
    reader.readAsDataURL(blob);
}

//example:
var buf = new Uint8Array([11,22,33]);
arrayBufferToBase64(buf, console.log.bind(console)); //"CxYh"
4
  • Use dataurl.split(',', 2)[1]instead of dataurl.substr(dataurl.indexOf(',')+1). Oct 31, 2018 at 21:40
  • 3
    This doesn't seem to be guaranteed to work. According to w3c.github.io/FileAPI/#issue-f80bda5b readAsDataURL could theoretically return a percent encoded dataURI (And it seems it is actually the case in jsdom)
    – T S
    Aug 22, 2019 at 19:00
  • @CarterMedlin Why would split be better than substring?
    – T S
    Aug 22, 2019 at 19:02
  • split is shorter. but dataurl may contains one or more commas(,), split is not safe.
    – cuixiping
    Aug 28, 2019 at 9:55
39

The OP did not specify the Running Environment but if you are using Node.JS there is a very simple way to do such thing.

According with the official Node.JS docs https://nodejs.org/api/buffer.html#buffer_buffers_and_character_encodings

// This step is only necessary if you don't already have a Buffer Object
const buffer = Buffer.from(yourArrayBuffer);

const base64String = buffer.toString('base64');

Also, If you are running under Angular for example, the Buffer Class will also be made available in a Browser Environment.

3
  • Your answer only applies to NodeJS and will not work in the browser.
    – jvatic
    Mar 9, 2020 at 18:50
  • 5
    @jvatic I see, the OP did not clearly specify the Running Environment, so my answer is not incorrect, he only tagged Javascript. So I updated my answer to make it more concise. I think this is an important answer because I was searching how to do this and could not get to the best answer to the problem. Mar 10, 2020 at 17:50
  • I came to realize recently that the Question date precedes NodeJS itself, which is more reason that the Mods should add an addendum to the question, because these days most people are looking for a solution on nodeJS and get mislead by the popularity of the old answers. Nov 24, 2022 at 8:39
36

This example uses the built-in FileReader readDataURL() to do the conversion to base64 encoding. Data URLs are structured data:[<mediatype>][;base64],<data>, so we split that url at the comma and return only the base64 encoded characters.

const blob = new Blob([array]);        
const reader = new FileReader();

reader.onload = (event) => {
  const dataUrl = event.target.result;
  const [_, base64] = dataUrl.split(','); 
  // do something with base64
};
   
reader.readAsDataURL(blob);

Or as a promisified utility:

async function encode(array) {
  return new Promise((resolve) => {
    const blob = new Blob([array]);
    const reader = new FileReader();
    
    reader.onload = (event) => {
      const dataUrl = event.target.result;
      const [_, base64] = dataUrl.split(',');
      
      resolve(base64);
    };
    
    reader.readAsDataURL(blob);
  });
}

const encoded = await encode(typedArray);
7
  • 4
    Add some explanation to your answer please. What does this code mean?
    – Oscar
    Oct 11, 2019 at 10:38
  • Similar helpful MDN example.
    – spenceryue
    Dec 16, 2019 at 11:53
  • 1
    this is by far the fastest approach - tens of times faster than the other ones in my limited testing
    – jitin
    Dec 28, 2019 at 15:55
  • i wish i'd found this solution like 8 hours again. my day would not have been wasted ;( thank you Jan 20, 2020 at 16:02
  • 5
    I think you also need to remove the DataURL header (data:*/*;base64,) to obtain just the Base64 string. See MDN docs
    – Larry K
    Feb 23, 2021 at 11:17
24

I used this and works for me.

function arrayBufferToBase64( buffer ) {
    var binary = '';
    var bytes = new Uint8Array( buffer );
    var len = bytes.byteLength;
    for (var i = 0; i < len; i++) {
        binary += String.fromCharCode( bytes[ i ] );
    }
    return window.btoa( binary );
}



function base64ToArrayBuffer(base64) {
    var binary_string =  window.atob(base64);
    var len = binary_string.length;
    var bytes = new Uint8Array( len );
    for (var i = 0; i < len; i++)        {
        bytes[i] = binary_string.charCodeAt(i);
    }
    return bytes.buffer;
}
3
  • Not safe. See @chemoish answer
    – Kugel
    Aug 24, 2017 at 4:57
  • 4
    This is the only solution i have found that worked for me.
    – se22as
    Dec 11, 2020 at 14:31
  • 1
    This is the most readable solution.
    – Waruyama
    May 10 at 6:11
18

My recommendation for this is to NOT use native btoa strategies—as they don't correctly encode all ArrayBuffer's…

rewrite the DOMs atob() and btoa()

Since DOMStrings are 16-bit-encoded strings, in most browsers calling window.btoa on a Unicode string will cause a Character Out Of Range exception if a character exceeds the range of a 8-bit ASCII-encoded character.

While I have never encountered this exact error, I have found that many of the ArrayBuffer's I have tried to encode have encoded incorrectly.

I would either use MDN recommendation or gist.

4
  • btoa not works on String, but OP is asking ArrayBuffer.
    – tsh
    Jun 17, 2017 at 3:18
  • 3
    Very much this, so many snippets here that recommend the wrong thing! I've seen this error multiple times, where people blindly use atob and btoa.
    – Kugel
    Aug 24, 2017 at 4:53
  • 14
    All array buffers should be encoded fine using the strategies in other answers, atob/btoa is only a problem for text that contains characters greater than 0xFF (which byte arrays by definition do not). The MDN warning doesn't apply because when using the strategy in the other answers you are guaranteed to have a string that only consists of ASCII characters as any value from a Uint8Array is guaranteed to be between 0 and 255 which means String.fromCharCode is guaranteed to return a character that is not out of range. Apr 29, 2019 at 6:44
  • This is the correct answer when btoa or Buffer are not available (react-native)
    – cancerbero
    May 14, 2021 at 18:42
16

Below are 2 simple functions for converting Uint8Array to Base64 String and back again

arrayToBase64String(a) {
    return btoa(String.fromCharCode(...a));
}

base64StringToArray(s) {
    let asciiString = atob(s);
    return new Uint8Array([...asciiString].map(char => char.charCodeAt(0)));
}
4
  • 2
    This is a confusing answer. That does not look look like valid JavaScript and is a Uint8Array an ArrayBuffer? Oct 20, 2018 at 15:06
  • @user1153660 Add the function keyword and it should work in a modern browser.
    – Yeti
    Nov 16, 2018 at 7:40
  • Awesome! btoa(String.fromCharCode(...a)); is shortest version I have seen so far to encode Uint8Array.
    – Nicolo
    Jun 27, 2019 at 8:37
  • 4
    This looks good but if the array is too huge it will throw maximum call stack size exceeded error. Oct 16, 2019 at 17:54
5

If you're okay with adding a library, base64-arraybuffer:

yarn add base64-arraybuffer

then:

  • encode(buffer) - Encodes ArrayBuffer into base64 string
  • decode(str) - Decodes base64 string to ArrayBuffer
1
  • 1
    best answer for me since includes the decoding
    – fjsj
    Jul 9, 2021 at 17:20
3

This worked for me:

Buffer.from(myArrayBuffer).toString("base64");
3
  • Is this specific to NodeJS, and does it perform a copy in the from method? Apr 14 at 15:32
  • idk, do you have the answer? Jul 5 at 6:46
  • If I knew the answer I would not have asked, I'd have improved your answer instead :) Jul 5 at 12:47
1
ABtoB64(ab) {
    return new Promise(res => {
        const fr = new FileReader();
        fr.onload = ({target: {result: s}}) => res(s.slice(s.indexOf(';base64,') + 8));
        fr.readAsDataURL(new Blob([ab]));
    });
}

asynchronous method using file reader.

0

You can derive a normal array from the ArrayBuffer by using Array.prototype.slice. Use a function like Array.prototype.map to convert bytes in to characters and join them together to forma string.

function arrayBufferToBase64(ab){

    var dView = new Uint8Array(ab);   //Get a byte view        

    var arr = Array.prototype.slice.call(dView); //Create a normal array        

    var arr1 = arr.map(function(item){        
      return String.fromCharCode(item);    //Convert
    });

    return window.btoa(arr1.join(''));   //Form a string

}

This method is faster since there are no string concatenations running in it.

1
  • Not safe. See @chemoish answer
    – Kugel
    Aug 24, 2017 at 4:58
0

i use TextDecode api to convert it to normal text and then convert it to Base64

const uint =  new Uint8Array([ 73, 32, 108, 111, 118, 101, 32, 121, 111, 117 ]).buffer
const decoder = new TextDecoder()
const decodedText = decoder.decode(uint)
const base64Code = btoa(decodedText)
0
 var uint8Array = new Uint8Array(BytesArray);

 var base64Str = btoa(String.fromCharCode(...uint8Array));

 Or,

 var base64Str = btoa(uint8Array.reduce((x, y) => x + String.fromCharCode(y), ''));
0

In the Browser suggested solutions with btoa seem fine. But in Node.js btoa is Legacy

It is recommended to use buffer.toString(encoding)

like

const myString = buffer.toString("base64")

-1

Use uint8-to-b64 package to do encoding/decoding in browser and Node.js

-4

By my side, using Chrome navigator, I had to use DataView() to read an arrayBuffer

function _arrayBufferToBase64( tabU8A ) {
var binary = '';
let lecteur_de_donnees = new DataView(tabU8A);
var len = lecteur_de_donnees.byteLength;
var chaine = '';
var pos1;
for (var i = 0; i < len; i++) {
    binary += String.fromCharCode( lecteur_de_donnees.getUint8( i ) );
}
chaine = window.btoa( binary )
return chaine;}
-6
function _arrayBufferToBase64(uarr) {
    var strings = [], chunksize = 0xffff;
    var len = uarr.length;

    for (var i = 0; i * chunksize < len; i++){
        strings.push(String.fromCharCode.apply(null, uarr.subarray(i * chunksize, (i + 1) * chunksize)));
    }

    return strings.join("");
}

This is better, if you use JSZip for unpack archive from string

0

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.