Comentários de JScript
Um comentário de JScript de única linha começa com um par de barras (/ /).
Comentários no código
Aqui está um exemplo de um comentário de linha única, seguido por uma linha de código.
// This is a single-line comment.
aGoodIdea = "Comment your code for clarity.";
Um comentário de JScript de várias linhas começa com uma barra invertida e o asterisco (/ *) e termina com o inverso (* /).
/*
This is a multiline comment that explains the preceding code statement.
The statement assigns a value to the aGoodIdea variable. The value,
which is contained between the quote marks, is called a literal. A
literal explicitly and directly contains information; it does not
refer to the information indirectly. The quote marks are not part
of the literal.
*/
Se você tentar incorporar um comentário de várias linhas dentro de outro, o JScript interpreta o comentário de várias linhas resultante de forma inesperada. O * / que marca o final da incorporado comentário de várias linhas é interpretado como o final do comentário de várias linhas inteiro. Conseqüentemente, o texto após o comentário de várias linhas incorporado é interpretado como código de JScript e pode gerar erros de sintaxe.
No exemplo a seguir, a terceira linha de texto é interpretada como código de JScript porque JScript é interpretado interno * / para o fim do comentário mais externo:
/* This is the outer-most comment
/* And this is the inner-most comment */
...Unfortunately, JScript will try to treat all of this as code. */
É recomendável que você escrever todos os comentários como blocos de comentários de linha única. Isso permite que você comente grandes segmentos de código com um comentário de várias linhas mais tarde.
// This is another multiline comment, written as a series of single-line comments.
// After the statement is executed, you can refer to the content of the aGoodIdea
// variable by using its name, as in the next statement, in which a string literal is
// appended to the aGoodIdea variable by concatenation to create a new variable.
var extendedIdea = aGoodIdea + " You never know when you'll have to figure out what it does.";
Como alternativa, você pode usar compilação condicional para fazer um comentário com eficácia grandes segmentos de código.