---
title: "BaseConverterSequence"
description: "Referencia completa de la clase de objeto de valor BaseConverterSequence para definir y validar alfabetos de conversión."
canonical_url: "https://nodecfdi.com/packages/base-converter/api-reference/base-converter-sequence"
---

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

La clase `BaseConverterSequence` es un objeto de valor inmutable que encapsula y valida la secuencia de caracteres (alfabeto) empleada por [`BaseConverter`](https://nodecfdi.com/packages/base-converter/api-reference/base-converter).

## Importación

```ts
import { BaseConverterSequence } from '@nodecfdi/base-converter';
```

## Constructor

### `new BaseConverterSequence(sequence)`

Crea una nueva secuencia validando primero su contenido mediante `BaseConverterSequence.checkIsValid(sequence)` y convirtiendo todos sus caracteres a mayúsculas.

- **Parámetros:**
  - `sequence`: `string` — Cadena con los caracteres únicos de la secuencia (mínimo 2 caracteres ASCII de un solo byte).
- **Excepciones (Error):** Lanza un error si la secuencia no cumple con las reglas de validación (ver `checkIsValid`).

```ts
const sequence = new BaseConverterSequence('01234567');
```

## Métodos estáticos

### `BaseConverterSequence.isValid(value)`

Evalúa si una cadena cumple con todas las reglas para ser una secuencia válida sin lanzar excepciones.

- **Parámetros:**
  - `value`: `string` — Cadena a evaluar.
- **Retorna:** `boolean` — `true` si la secuencia es válida, `false` en caso contrario.

```ts
BaseConverterSequence.isValid('01'); // true
BaseConverterSequence.isValid('010'); // false
```

### `BaseConverterSequence.checkIsValid(sequence)`

Verifica que la cadena cumpla con los requisitos de una secuencia válida. Si alguna regla falla, lanza una excepción `Error`.

- **Parámetros:**
  - `sequence`: `string` — Cadena a verificar.
- **Retorna:** `void`
- **Excepciones (Error):**
  - `'Sequence does not contains enough elements'`: Si la longitud en bytes es menor a `2`.
  - `'Cannot use multibyte strings in dictionary'`: Si la longitud en bytes UTF-8 difiere de `sequence.length` (contiene caracteres multibyte).
  - `'The sequence has not unique values'`: Si tras convertir a mayúsculas existen caracteres repetidos.

```ts
BaseConverterSequence.checkIsValid('0123456789ABCDEF');
```

## Métodos de instancia

### `value()`

Devuelve la cadena de la secuencia normalizada en mayúsculas.

- **Retorna:** `string`

```ts
const sequence = new BaseConverterSequence('abcdef');
console.log(sequence.value()); // "ABCDEF"
```

### `toString()`

Alias de `value()` que permite convertir la instancia directamente a cadena de texto.

- **Retorna:** `string`

```ts
const sequence = new BaseConverterSequence('01');
console.log(String(sequence)); // "01"
```

### `length()`

Devuelve la cantidad de caracteres de la secuencia.

- **Retorna:** `number`

```ts
const sequence = new BaseConverterSequence('0123456789ABCDEF');
console.log(sequence.length()); // 16
```

## Sitemap

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