Instruções de compilação condicional
As instruções a seguir permitem JScript controlar a compilação de um script, dependendo dos valores das variáveis de compilação condicional. Você pode usar as variáveis fornecidas por JScript ou você pode definir seu próprio com o @set diretiva ou o /define opção de linha de comando.
Instruções
Instrução |
Descrição |
|---|---|
Ativa o suporte de compilação condicional. |
|
Executa condicionalmente um grupo de declarações, dependendo do valor de uma expressão. |
|
Cria variáveis usadas com instruções de compilação condicional. |
O @cc\_on, @if, ou @set instruções ativar compilação condicional. Alguns usos típicos para compilação condicional incluem usando os novos recursos JScript, incorporando o suporte à depuração em um script e execução de código de rastreamento.
Ao escrever os scripts sejam executados por navegadores da Web, sempre coloque o código de compilação condicional nos comentários. Conseqüentemente, os hosts que não oferecem suporte a compilação condicional podem ignorá-la. Aqui está um exemplo.
/*@cc_on @*/
/*@if (@_jscript_version >= 5)
document.write("JScript Version 5.0 or better.<BR>");
@else @*/
document.write("You need a more recent script engine.<BR>");
/*@end @*/
Este exemplo usa os delimitadores de comentários especiais que são usados somente se o @cc\_on tiver ativado a instrução de compilação condicional. Os mecanismos de script não oferecem suporte a compilação condicional exibem uma mensagem avisando sobre a necessidade de um novo mecanismo de script sem gerar erros. Os mecanismos que oferecem suporte a compilação condicional compilar o primeiro ou segundo document.write, dependendo da versão do mecanismo. Observe que a versão 7.x representa o JScript.NET. Para obter mais informações, consulte Detecção de capacidades do navegador.
Compilação condicional também é útil para scripts do lado do servidor e programas de linha de comando. Nesses aplicativos, a compilação condicional pode ser usada para compilar a funções adicionais em um programa para ajudar na criação de perfil quando estiver no modo de depuração.
Consulte também
Referência
Conceitos
Variáveis de compilação condicional
Diretivas de compilação condicional
Detecção de capacidades do navegador