Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
return
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
Resumen
La sentenciareturn 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,
undefinedes 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: Usandoreturn
La siguiente función devuelve el cuadrado de su argumento,x, dondex es un número.
function cuadrado(x) { return x * x;}