Buscar..
Sintaxis
-
// Single line comment (continues until line break) -
/* Multi line comment */ -
<!-- Single line comment starting with the opening HTML comment segment "<!--" (continues until line break) -
--> Single line comment starting with the closing HTML comment segment "-->" (continues until line break)
Usando comentarios
Para agregar anotaciones, sugerencias o excluir algún código de la ejecución, JavaScript proporciona dos formas de comentar líneas de código
Línea única Comentario //
Todo después de la // hasta el final de la línea se excluye de la ejecución.
function elementAt( event ) {
// Gets the element from Event coordinates
return document.elementFromPoint(event.clientX, event.clientY);
}
// TODO: write more cool stuff!
Comentario multilínea /**/
Todo lo que se encuentre entre la apertura /* y el cierre */ se excluye de la ejecución, incluso si la apertura y el cierre se realizan en líneas diferentes.
/*
Gets the element from Event coordinates.
Use like:
var clickedEl = someEl.addEventListener("click", elementAt, false);
*/
function elementAt( event ) {
return document.elementFromPoint(event.clientX, event.clientY);
}
/* TODO: write more useful comments! */
Usando comentarios HTML en JavaScript (Mala práctica)
Los comentarios HTML (opcionalmente precedidos por espacios en blanco) harán que el navegador también ignore el código (en la misma línea), aunque esto se considera una mala práctica .
Comentarios de una línea con la secuencia de apertura de comentarios HTML ( <!-- ):
Nota: el intérprete de JavaScript ignora los caracteres de cierre de los comentarios HTML (
-->) aquí.
<!-- A single-line comment.
<!-- --> Identical to using `//` since
<!-- --> the closing `-->` is ignored.
Esta técnica se puede observar en el código heredado para ocultar JavaScript de los navegadores que no lo admiten:
<script type="text/javascript" language="JavaScript">
<!--
/* Arbitrary JavaScript code.
Old browsers would treat
it as HTML code. */
// -->
</script>
Un comentario de cierre de HTML también se puede usar en JavaScript (independientemente de un comentario de apertura) al principio de una línea (opcionalmente precedido por espacios en blanco), en cuyo caso también hace que se ignore el resto de la línea:
--> Unreachable JS code
Estos hechos también se han explotado para permitir que una página se llame a sí misma primero como HTML y luego como JavaScript. Por ejemplo:
<!--
self.postMessage('reached JS "file"');
/*
-->
<!DOCTYPE html>
<script>
var w1 = new Worker('#1');
w1.onmessage = function (e) {
console.log(e.data); // 'reached JS "file"
};
</script>
<!--
*/
-->
Cuando se ejecuta un HTML, todo el texto de varias líneas entre los comentarios <!-- y --> se ignora, por lo que el JavaScript contenido en él se ignora cuando se ejecuta como HTML.
Sin embargo, como JavaScript, mientras que las líneas que comienzan con <!-- y --> se ignoran, su efecto no es escapar sobre varias líneas, por lo que las líneas que las siguen (por ejemplo, self.postMessage(... ) no serán se ignoran cuando se ejecutan como JavaScript, al menos hasta que lleguen a un comentario de JavaScript , marcado con /* y */ . Tales comentarios de JavaScript se usan en el ejemplo anterior para ignorar el texto HTML restante (hasta que --> que también se ignora como JavaScript ).