base64

base64

base64 adalah encoder/decoder base64 tangguh yang sepenuhnya kompatibel dengan atob() dan btoa() , yang ditulis dalam JavaScript. Algoritme pengkodean dan decoding base64 yang digunakan sepenuhnya sesuai dengan RFC 4648.

Instalasi

Melalui npm:

npm install base-64

Di peramban:

 < script src =" base64.js " > </ script >

Di Narwhal, Node.js, dan RingoJS:

 var base64 = require ( 'base-64' ) ;

Di Badak:

 load ( 'base64.js' ) ;

Menggunakan pemuat AMD seperti RequireJS:

 require (
  {
    'paths' : {
      'base64' : 'path/to/base64'
    }
  } ,
  [ 'base64' ] ,
  function ( base64 ) {
    console . log ( base64 ) ;
  }
) ; 

API

base64.version

Sebuah string yang mewakili nomor versi semantik.

base64.encode(input)

Fungsi ini mengambil string byte (parameter input ) dan mengkodekannya sesuai dengan base64. Data masukan harus dalam bentuk string yang hanya berisi karakter dalam rentang U+0000 hingga U+00FF, masing-masing mewakili byte biner dengan nilai 0x00 hingga 0xFF . Fungsi base64.encode() dirancang agar sepenuhnya kompatibel dengan btoa() seperti yang dijelaskan dalam Standar HTML.

 var encodedData = base64 . encode ( input ) ;

Untuk mengkodekan string Unicode apa pun dengan base64, enkodekan string tersebut sebagai UTF-8 terlebih dahulu:

 var base64 = require ( 'base-64' ) ;
var utf8 = require ( 'utf8' ) ;

var text = 'foo © bar ? baz' ;
var bytes = utf8 . encode ( text ) ;
var encoded = base64 . encode ( bytes ) ;
console . log ( encoded ) ;
// → 'Zm9vIMKpIGJhciDwnYyGIGJheg=='

base64.decode(input)

Fungsi ini mengambil string yang dikodekan base64 (parameter input ) dan menerjemahkannya. Nilai yang dikembalikan berupa string yang hanya berisi karakter dalam rentang U+0000 hingga U+00FF, masing-masing mewakili byte biner dengan nilai 0x00 hingga 0xFF . Fungsi base64.decode() dirancang agar sepenuhnya kompatibel dengan atob() seperti yang dijelaskan dalam Standar HTML.

 var decodedData = base64 . decode ( encodedData ) ;

Untuk mendekode data yang dikodekan UTF-8 base64 kembali menjadi string Unicode, dekode UTF-8 setelah dekode base64:

 var encoded = 'Zm9vIMKpIGJhciDwnYyGIGJheg==' ;
var bytes = base64 . decode ( encoded ) ;
var text = utf8 . decode ( bytes ) ;
console . log ( text ) ;
// → 'foo © bar ? baz' 

Mendukung

base64 dirancang untuk bekerja setidaknya di Node.js v0.10.0, Narwhal 0.3.2, RingoJS 0.8-0.9, PhantomJS 1.9.0, Rhino 1.7RC4, serta Chrome, Firefox, Safari, Opera, versi lama dan modern, dan Internet Explorer.

Tes unit & cakupan kode

Setelah mengkloning repositori ini, jalankan npm install untuk menginstal dependensi yang diperlukan untuk pengembangan dan pengujian. Anda mungkin ingin menginstal Istanbul secara global menggunakan npm install istanbul -g .

Setelah selesai, Anda dapat menjalankan pengujian unit di Node menggunakan npm test atau node tests/tests.js . Untuk menjalankan pengujian di Rhino, Ringo, Narwhal, dan juga browser web, gunakan grunt test .

Untuk menghasilkan laporan cakupan kode, gunakan grunt cover .

Pengarang

Mathias Bynens

Lisensi

base64 tersedia di bawah lisensi MIT.