mirror of
https://github.com/azure/login.git
synced 2026-03-15 09:20:56 -04:00
45b10ffd19
* Bump lodash from 4.17.15 to 4.17.19 (#52) Bumps [lodash](https://github.com/lodash/lodash) from 4.17.15 to 4.17.19. - [Release notes](https://github.com/lodash/lodash/releases) - [Commits](https://github.com/lodash/lodash/compare/4.17.15...4.17.19) Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Amruta Kawade <65217380+AmrutaKawade@users.noreply.github.com> * Bump @actions/core from 1.1.3 to 1.2.6 (#60) Bumps [@actions/core](https://github.com/actions/toolkit/tree/HEAD/packages/core) from 1.1.3 to 1.2.6. - [Release notes](https://github.com/actions/toolkit/releases) - [Changelog](https://github.com/actions/toolkit/blob/main/packages/core/RELEASES.md) - [Commits](https://github.com/actions/toolkit/commits/HEAD/packages/core) Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Amruta Kawade <65217380+AmrutaKawade@users.noreply.github.com> * updating node_nodules * updated package-lock Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
51 lines
2.0 KiB
Markdown
51 lines
2.0 KiB
Markdown
# abab [](https://www.npmjs.com/package/abab) [](https://travis-ci.org/jsdom/abab)
|
|
|
|
A JavaScript module that implements `window.atob` and `window.btoa` according the forgiving-base64 algorithm in the [Infra Standard](https://infra.spec.whatwg.org/#forgiving-base64). The original code was forked from [w3c/web-platform-tests](https://github.com/w3c/web-platform-tests/blob/master/html/webappapis/atob/base64.html).
|
|
|
|
Compatibility: Node.js version 3+ and all major browsers.
|
|
|
|
Install with `npm`:
|
|
|
|
```sh
|
|
npm install abab
|
|
```
|
|
|
|
## API
|
|
|
|
### `btoa` (base64 encode)
|
|
|
|
```js
|
|
const { btoa } = require('abab');
|
|
btoa('Hello, world!'); // 'SGVsbG8sIHdvcmxkIQ=='
|
|
```
|
|
|
|
### `atob` (base64 decode)
|
|
|
|
```js
|
|
const { atob } = require('abab');
|
|
atob('SGVsbG8sIHdvcmxkIQ=='); // 'Hello, world!'
|
|
```
|
|
|
|
#### Valid characters
|
|
|
|
[Per the spec](https://html.spec.whatwg.org/multipage/webappapis.html#atob:dom-windowbase64-btoa-3), `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`.
|
|
|
|
## Browsers
|
|
|
|
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.
|
|
|
|
```js
|
|
const atob = require('abab/lib/atob');
|
|
const btoa = require('abab/lib/btoa');
|
|
```
|
|
|
|
-----
|
|
|
|
### Checklists
|
|
|
|
If you're **submitting a PR** or **deploying to npm**, please use the [checklists in CONTRIBUTING.md](https://github.com/jsdom/abab/blob/master/CONTRIBUTING.md#checklists)
|
|
|
|
### Remembering `atob` vs. `btoa`
|
|
|
|
Here's a mnemonic that might be useful: if you have a plain string and want to base64 encode it, then decode it, `btoa` is what you run before (**b**efore - **b**toa), and `atob` is what you run after (**a**fter - **a**tob).
|