base64

base64

base64 es un codificador/decodificador base64 robusto que es totalmente compatible con atob() y btoa() , escrito en JavaScript. Los algoritmos de codificación y decodificación base64 que utiliza son totalmente compatibles con RFC 4648.

Instalación

A través de npm:

npm install base-64

En un navegador:

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

En Narwhal, Node.js y RingoJS:

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

En rinoceronte:

 load ( 'base64.js' ) ;

Usando un cargador AMD como RequireJS:

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

API

base64.version

Una cadena que representa el número de versión semántica.

base64.encode(input)

Esta función toma una cadena de bytes (el parámetro input ) y la codifica según base64. Los datos de entrada deben tener la forma de una cadena que contenga solo caracteres en el rango de U+0000 a U+00FF, cada uno de los cuales representa un byte binario con valores de 0x00 a 0xFF . La función base64.encode() está diseñada para ser totalmente compatible con btoa() como se describe en el estándar HTML.

 var encodedData = base64 . encode ( input ) ;

Para codificar en base64 cualquier cadena Unicode, codifíquela primero como UTF-8:

 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)

Esta función toma una cadena codificada en base64 (el parámetro input ) y la decodifica. El valor de retorno tiene la forma de una cadena que contiene solo caracteres en el rango de U+0000 a U+00FF, cada uno de los cuales representa un byte binario con valores de 0x00 a 0xFF . La función base64.decode() está diseñada para ser totalmente compatible con atob() como se describe en el estándar HTML.

 var decodedData = base64 . decode ( encodedData ) ;

Para decodificar datos codificados en base64 en UTF-8 nuevamente en una cadena Unicode, decodificalos en UTF-8 después de decodificarlos en base64:

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

Apoyo

base64 está diseñado para funcionar al menos en Node.js v0.10.0, Narwhal 0.3.2, RingoJS 0.8-0.9, PhantomJS 1.9.0, Rhino 1.7RC4, así como en versiones antiguas y modernas de Chrome, Firefox, Safari, Opera, e Internet Explorer.

Pruebas unitarias y cobertura de código

Después de clonar este repositorio, ejecute npm install para instalar las dependencias necesarias para el desarrollo y las pruebas. Es posible que desees instalar Estambul globalmente usando npm install istanbul -g .

Una vez hecho esto, puede ejecutar las pruebas unitarias en Node usando npm test o node tests/tests.js . Para ejecutar las pruebas en Rhino, Ringo, Narwhal y también en navegadores web, utilice grunt test .

Para generar el informe de cobertura del código, utilice grunt cover .

Autor

Mathias Bynens

Licencia

base64 está disponible bajo la licencia MIT.