std/encoding/base64url.ts


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

// Copyright 2018-2020 the Deno authors. All rights reserved. MIT license.

import {
  decode as convertBase64ToArrayBuffer,
  encode as convertArrayBufferToBase64,
} from "./base64.ts";

/*
 * Some variants allow or require omitting the padding '=' signs:
 * https://en.wikipedia.org/wiki/Base64#URL_applications
 */
export function addPaddingToBase64url(base64url: string): string {
  if (base64url.length % 4 === 2) return base64url + "==";
  if (base64url.length % 4 === 3) return base64url + "=";
  if (base64url.length % 4 === 1) {
    throw new TypeError("Illegal base64url string!");
  }
  return base64url;
}

function convertBase64urlToBase64(base64url: string): string {
  return addPaddingToBase64url(base64url)
    .replace(/\-/g, "+")
    .replace(/_/g, "/");
}

function convertBase64ToBase64url(base64: string): string {
  return base64.replace(/=/g, "").replace(/\+/g, "-").replace(/\//g, "_");
}

/**
 * Converts given data with base64url encoding.
 * Removes paddings '='.
 * @param data input to encode
 */
export function encode(data: string | ArrayBuffer): string {
  return convertBase64ToBase64url(convertArrayBufferToBase64(data));
}

/**
 * Converts given base64url encoded data back to original
 * @param data input to decode
 */
export function decode(data: string): ArrayBuffer {
  return convertBase64ToArrayBuffer(convertBase64urlToBase64(data));
}