A virtual teacher who reveals to you the great secrets of Base64

JavaScript Base64 Encode

To encode data in Base64, JavaScript provides a function called btoa which is an acronym for “Binary to ASCII”. The inverse transformation is achieved by using the function atob.

Usage:

  • btoa(data) - Converts data to STRING and encodes it to Base64

Arguments:

  • data (required string) - Text or binary content that you want to encode

Return Values:

  • STRING - On success, it returns the Base64 value, typically longer by about 33% than data

Exceptions:

On failure the function may throw one of the following exceptions:

  • InvalidCharacterError: String contains an invalid character
  • TypeError: Not enough arguments to Window.btoa

Example #1 (basic usage):

var b64 = btoa('guru');
console.log(b64); //-> "Z3VydQ=="

Example #2 (check if function is supported):

if (typeof btoa !== 'function') {
  // Cannot encode data to Base64 because the btoa() function is not supported
  // Perhaps you want to use a polyfill or at least inform user about this
}

Example #3 (non-string data):

// Before encoding data to Base64 the btoa() function converts it to String()
// It is for this reason that you will not get any errors if you pass a “wrong” data type
// For example, that is why in the examples below you will get the same results

btoa(null); //-> "bnVsbA=="
btoa('null'); //-> "bnVsbA=="

btoa({}); //-> "W29iamVjdCBPYmplY3Rd"
btoa('[object Object]'); //-> "W29iamVjdCBPYmplY3Rd"

btoa([0,1]); //-> "MCwx"
btoa('0,1'); //-> "MCwx"

btoa(function(){}); //-> "ZnVuY3Rpb24oKXt9"
btoa('function(){}'); //-> "ZnVuY3Rpb24oKXt9"

Example #4 (unicode string):

// By default most browsers don’t support Unicode strings
// This is why the following example throws an exception
try {
  btoa('€100');
} catch (e) {
  console.log(e); //-> "DOMException: String contains an invalid character"
}

For more info, check the following examples:

Comments (4)

I hope you enjoy this discussion. In any case, I ask you to join it.

  • Bharati,
    Hi, I am Bharati I am trying to use btoa function in Java with Selenium to automate one of the Test Case to convert Non-English characters like Chinese. But I am unable to use window.btoa funciton. Please help me how to use this?

    Thanks in Advance,
    Bharati.
    • Administrator,
      Hello Bharati! So you use Java or JavaScript?
  • David_Palencia,
    Hi, I am trying encode PDF to base64, but when i try to decode and preview, the pdf is empty
    • Administrator,
      Hello David! What is the source of the PDF file? It is a Blob, URL, or “local” file? Can you show please the basic part of your code?
Add new comment

If you have any questions, remarks, need help, or just like this page, please feel free to let me know by leaving a comment using the form bellow.
I will be happy to read every comment and, if necessary, I will do my best to respond as quickly as possible. Of course, spammers are welcome only as readers.

Loading...