Weekly downloads
Changelog
2.0.6
Readme
A JavaScript module that implements window.atob
and window.btoa
according the forgiving-base64 algorithm in the Infra Standard. The original code was forked from w3c/web-platform-tests.
Compatibility: Node.js version 3+ and all major browsers.
Install with npm
:
npm install abab
btoa
(base64 encode)const { btoa } = require('abab');
btoa('Hello, world!'); // 'SGVsbG8sIHdvcmxkIQ=='
atob
(base64 decode)const { atob } = require('abab');
atob('SGVsbG8sIHdvcmxkIQ=='); // 'Hello, world!'
Per the spec, btoa
will accept strings "containing only characters in the range U+0000
to U+00FF
." If passed a string with characters above U+00FF
, btoa
will return null
. If atob
is passed a string that is not base64-valid, it will also return null
. In both cases when null
is returned, the spec calls for throwing a DOMException
of type InvalidCharacterError
.
If you want to include just one of the methods to save bytes in your client-side code, you can require
the desired module directly.
const atob = require('abab/lib/atob');
const btoa = require('abab/lib/btoa');
If you're submitting a PR or deploying to npm, please use the checklists in CONTRIBUTING.md.
atob
and btoa
stand forBase64 comes from IETF RFC 4648 (2006).
btoa
, the encoder function, stands for binary to ASCII, meaning it converts any binary input into a subset of ASCII (Base64).atob
, the decoder function, converts ASCII (or Base64) to its original binary format.WHATWG spec-compliant implementations of window.atob and window.btoa.
The npm package abab receives a total of 17,508,574 weekly downloads. As such, abab popularity was classified as popular.
We found that abab demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago.It has 1 open source maintainer collaborating on the project.
Did you know?
Socket installs a Github app to automatically flag issues on every pull request and report the health of your dependencies. Find out what is inside your node modules and prevent malicious activity before you update the dependencies.