---
title: "Introducción"
description: "Librería en TypeScript y JavaScript para convertir números de longitud arbitraria entre diferentes bases numéricas sin pérdida de precisión."
canonical_url: "https://nodecfdi.com/packages/base-converter/getting-started/introduction"
---

> Index of every page on this site: [llms.txt](https://nodecfdi.com/llms.txt)

`@nodecfdi/base-converter` es una librería escrita en TypeScript diseñada para convertir cadenas numéricas entre bases arbitrarias (desde base 2 en adelante) sin sufrir las limitaciones de precisión de los tipos numéricos nativos de JavaScript (`Number.parseInt` o `Number.parseFloat`).

## ¿Por qué usar Base Converter?

En JavaScript estándar, `Number.parseInt(valor, base)` pierde precisión cuando el número supera `Number.MAX_SAFE_INTEGER` (<span className="katex">
<span className="katex-mathml">
<math xmlns="http://www.w3.org/1998/Math/MathML">
<semantics>
<mrow>
<msup>
<mn>

2

</mn>

<mn>

53

</mn>
</msup>

<mo>

−

</mo>

<mn>

1

</mn>
</mrow>

<annotation encoding="application/x-tex">

2^{53} - 1

</annotation>
</semantics>
</math>
</span>

<span className="katex-html" ariaHidden="true">
<span className="base">
<span className="strut" style="height:0.8974em;vertical-align:-0.0833em;">



</span>

<span className="mord">
<span className="mord">

2

</span>

<span className="msupsub">
<span className="vlist-t">
<span className="vlist-r">
<span className="vlist" style="height:0.8141em;">
<span style="top:-3.063em;margin-right:0.05em;">
<span className="pstrut" style="height:2.7em;">



</span>

<span className="sizing,reset-size6,size3,mtight">
<span className="mord,mtight">
<span className="mord,mtight">

53

</span>
</span>
</span>
</span>
</span>
</span>
</span>
</span>
</span>

<span className="mspace" style="margin-right:0.2222em;">



</span>

<span className="mbin">

−

</span>

<span className="mspace" style="margin-right:0.2222em;">



</span>
</span>

<span className="base">
<span className="strut" style="height:0.6444em;">



</span>

<span className="mord">

1

</span>
</span>
</span>
</span>

) o utiliza notación científica a partir de <span className="katex">
<span className="katex-mathml">
<math xmlns="http://www.w3.org/1998/Math/MathML">
<semantics>
<mrow>
<msup>
<mn>

10

</mn>

<mn>

21

</mn>
</msup>
</mrow>

<annotation encoding="application/x-tex">

10^{21}

</annotation>
</semantics>
</math>
</span>

<span className="katex-html" ariaHidden="true">
<span className="base">
<span className="strut" style="height:0.8141em;">



</span>

<span className="mord">

1

</span>

<span className="mord">
<span className="mord">

0

</span>

<span className="msupsub">
<span className="vlist-t">
<span className="vlist-r">
<span className="vlist" style="height:0.8141em;">
<span style="top:-3.063em;margin-right:0.05em;">
<span className="pstrut" style="height:2.7em;">



</span>

<span className="sizing,reset-size6,size3,mtight">
<span className="mord,mtight">
<span className="mord,mtight">

21

</span>
</span>
</span>
</span>
</span>
</span>
</span>
</span>
</span>
</span>
</span>
</span>

. Esto representa un problema crítico cuando se procesan números de serie de certificados digitales (como los CSD o e.firma del SAT de 20 dígitos hexadecimales / 40 caracteres) u otros identificadores criptográficos extensos.

`@nodecfdi/base-converter` resuelve este problema operando directamente sobre secuencias de caracteres con aritmética de precisión arbitraria.

## Características principales

- **Precisión arbitraria**: Convierte números de cualquier longitud sin desbordamientos ni pérdida de dígitos.
- **Secuencias personalizadas**: Define tu propio alfabeto o diccionario de caracteres mediante [`BaseConverterSequence`](https://nodecfdi.com/packages/base-converter/api-reference/base-converter-sequence).
- **Soporte Base 36 integrado**: Incluye un método de fábrica listo para usar con el estándar alfanumérico (`0-9` y `A-Z`).
- **Multiplataforma (Isomórfico)**: Funciona sin dependencias externas tanto en **Node.js** como en **navegadores modernos**.
- **Tipado estricto**: Desarrollado íntegramente en TypeScript con definiciones de tipos incluidas.

## Requisitos

<table>
<thead>
  <tr>
    <th align="left">
      Entorno
    </th>
    
    <th align="left">
      Versión requerida
    </th>
  </tr>
</thead>

<tbody>
  <tr>
    <td align="left">
      <strong>
        Node.js
      </strong>
    </td>
    
    <td align="left">
      <code>
        ^22.13.0 || ^24 || ^26
      </code>
      
       (ESM)
    </td>
  </tr>
  
  <tr>
    <td align="left">
      <strong>
        Navegadores
      </strong>
    </td>
    
    <td align="left">
      Navegadores modernos (<code>
        defaults, not IE 11
      </code>
      
      )
    </td>
  </tr>
</tbody>
</table>

## Siguientes pasos

Comienza instalando el paquete en tu proyecto visitando la guía de [Instalación](https://nodecfdi.com/packages/base-converter/getting-started/installation) o revisa los ejemplos de [Conversión básica](https://nodecfdi.com/packages/base-converter/usage/basic-conversion).

## Sitemap

See the full [sitemap](https://nodecfdi.com/sitemap.md) for all pages.
