return
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Resumen
La sentencia return
finaliza la ejecución de la función y especifica un valor para ser devuelto a quien llama a la función.
Sintaxis
return [[ expresion ]];
- expresion
-
La expresión a retornar. Si se omite,
undefined
es retornado en su lugar.
Description
Cuando una instrucción de retorno se llama en una función, se detiene la ejecución de esta. Si se especifica un valor dado, este se devuelve a quien llama a la función. Si se omite la expresión, undefined
se devuelve en su lugar. Todas las siguientes sentencias de retorno rompen la ejecución de la función:
return;
return true;
return false;
return x;
return x + y / 3;
La inserción automática Punto y coma
La instrucción de retorno se ve afectada por la inserción automática de punto y coma (ASI). No se permite el terminador de línea entre la palabra clave de retorno y la expresión.
return;
a + b;
se transforma por ASI en:
return; a + b;
La consola le advertirá "código inalcanzable después de la declaración de retorno".
Nota: A partir de Gecko 40 (Firefox 40 / Thunderbird 40 / SeaMonkey 2.37), una advertencia es mostrada en la consola si se encuentra código inalcanzable despues de una instrucción return.
Ejemplos
Ejemplo: Usando return
La siguiente función devuelve el cuadrado de su argumento, x
, donde x
es un número.
function cuadrado(x) {
return x * x;
}