# gt-node: General Translation Node.js SDK: derive
URL: https://generaltranslation.com/es/docs/node/reference/functions/derive.mdx
---

title: derive
description: Marca el contenido calculado como derivable para la extracción de General Translation. Referencia de la API de derive.

---

Marca como derivable por el compilador y la CLI de General Translation el contenido que se calcula a partir del código fuente. Usa `derive` cuando una cadena traducida interpola un valor que debe detectarse durante la extracción, en lugar de tratarse como una variable de tiempo de ejecución.

## Resumen [#overview]

Envuelve una expresión calculada con `derive` dentro de una cadena traducida. La CLI resuelve la expresión en todos sus posibles valores estáticos e incluye esos valores en el contenido de origen que se va a traducir. En tiempo de ejecución, `derive` devuelve su argumento sin cambios.

```ts
import { derive, getGT } from 'gt-node';

const gt = await getGT();
const message = gt(`My name is ${derive(getSubject())}`);
```

Firma:

```ts
derive<T extends string | boolean | number | null | undefined>(content: T): T
```

*Nota: `derive` es un marcador de compile-time. Ejecuta `gt validate` después de añadir o modificar llamadas a `derive` para confirmar que la CLI pueda resolver cada expresión derivable.*

## Cómo funciona [#how-it-works]

* **Pista de extracción.** El CLI intenta resolver la expresión encapsulada en todos sus posibles valores estáticos y los agrega al contenido enviado para traducción.
* **Paso directo en tiempo de ejecución.** En tiempo de ejecución, `derive` devuelve exactamente lo que recibe, así que no afecta al valor.
* **Valores no derivables.** Cuando una expresión no puede analizarse de forma estática, envuélvela con [`declareVar`](/docs/node/reference/functions/declare-var) dentro de la llamada a `derive`.

## Parámetros [#parameters]

| Parámetro             | Descripción                                    | Type                                               | Opcional | Predeterminado |
| --------------------- | ---------------------------------------------- | -------------------------------------------------- | -------- | -------------- |
| [`content`](#content) | El contenido que debe marcarse como derivable. | `string \| boolean \| number \| null \| undefined` | No       | —              |

### `content` [#content]

**Tipo** `string | boolean | number | null | undefined` · **Obligatorio**

El contenido que debe marcarse como derivable para la extracción de traducciones.

## Valor devuelto [#returns]

**Tipo** `T`

El mismo contenido, sin cambios en tiempo de ejecución.

## Ejemplos [#examples]

```ts
import { derive, getGT } from 'gt-node';

function getSubject() {
  return Math.random() > 0.5 ? 'Alice' : 'Brian';
}

const gt = await getGT();
const greeting = gt(`My name is ${derive(getSubject())}`);
```

## Notas [#notes]

* `derive` solo afecta la extracción; nunca cambia el valor en tiempo de ejecución.
* Úsalo junto con [`declareVar`](/docs/node/reference/functions/declare-var) para valores que no se pueden resolver de forma estática.