Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

return — salir de una función y devolver un valor

La instrucción return termina la ejecución de una función y puede enviar un resultado al punto desde el que se llamó. Aprende sobre return sin expresión, las salidas anticipadas y el problema del salto de línea.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

return;
return expression;

return es una palabra clave reservada. En una función ordinaria, return expression; evalúa la expresión y devuelve su valor al punto desde el que se llamó. return; devuelve undefined; se obtiene el mismo resultado al llegar al final de una función ordinaria sin return. La instrucción no está permitida en el nivel superior de un script estándar o de un módulo.

Usa un return anticipado para salir de una función después de comprobar una condición. Sale de toda la función actual, no solo de un bucle que la contenga. En el ejemplo, doublePositive(0) sale antes de la multiplicación, mientras que doublePositive(3) devuelve 6.

No pongas un salto de línea entre return y la expresión que se devuelve. La inserción automática de punto y coma puede terminar entonces la instrucción como return;. Para una expresión en varias líneas, empieza, por ejemplo, con return ( y continúa en las líneas siguientes.

Un bloque finally se ejecuta antes de que se complete un retorno pendiente. Su propio return o throw puede sustituir ese resultado, así que evita esas sustituciones. return es sintaxis de ECMAScript, no una API web; el ejemplo no requiere ninguna API del navegador.

Ejemplos

function doublePositive(value) {
  if (value <= 0) return;
  return value * 2;
}

console.log(doublePositive(3));
console.log(doublePositive(0));

Resultado

6
undefined

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes