Começando com a versão 6.1, o NetBeans IDE fornece recursos de edição de JavaScript aprimorados que são modelados no suporte já fornecido para Java, Ruby e outras linguagens. Este guia fornece uma visão geral desses recursos.
Nesta seção, apresentamos os recursos básicos de edição de JavaScript do IDE.
Criando novos arquivos
Você pode criar um novo arquivo JavaScript em qualquer projeto através do assistente para Novo arquivo. Clique em Novo ->Outro para abrir o assistente. No assistente, abra a categoria Outro e selecione o arquivo JavaScript. Um novo arquivo JavaScript é criado a partir de um modelo.
Se você quiser que o arquivo JavaScript fique visível no editor do projeto, crie o arquivo JavaScript em uma subpasta apropriada do projeto, tal como src.
O modelo JavaScript padrão contém somente informações de licenciamento. Para adicionar o conteúdo ao modelo, vá para Ferramentas -> Modelos e abra o modelo JavaScript no IDE.
Realce de sintaxe
O IDE fornece realce de semântica verdadeiro para distinguir métodos e variáveis.
Código dobrável
O código do método pode ser dobrado ou expandido. No editor, clique no ícone ao lado de um método e ele dobra. Clique no ícone ao lado de um método dobrado e ele se expande. O código dobrado é indicado por uma caixa de reticências. Mantenha o cursor sobre a caixa de reticências e o IDE exibe o método recolhido.
Você pode dobrar ou expandir todos os métodos no menu Exibir -> Dobraduras de código.
Navegação
A aba Navegador do IDE exibe a estrutura do arquivo JavaScript. O Navegador reconhece as definições de classe de estilo protótipo e as mostra como classes com métodos.
Analisador de segundo plano
Um analisador é executado em segundo plano e fornece mensagens de erro detalhadas.
Correspondência de colchete
Os colchetes se fecham automaticamente. Digitar ', ", [, ( ou { insere um símbolo de fechamento correspondente. Digitar o símbolo de fechamento sobreporá o símbolo já inserido. Dar backspace no símbolo de abertura remove o símbolo correspondente.
Formatando
Pressionar nova linha recua o cursor com base em onde a próxima linha deverá estar. Pressionar uma } recuará para esquerda a linha imediatamente. Reformatar uma seleção ou o buffer inteiro recua novamente o arquivo inteiro.
Suporte a JSON
Os arquivos JSON são tratados como JavaScript. O analisador de segundo plano é executado em um modo JSON especial em que permite somente uma expressão literal de objeto sem funções, etc.
Realce de semântica
As declarações do método são mostradas em negrito (incluindo declarações de estilo de protótipo em literais de objeto), as variáveis globais são mostradas em verde, as variáveis não utilizadas são mostradas em sublinhado cinza.
Marcar ocorrências
Colocar o cursor em um símbolo realça outros usos da mesma variável ou chamada. Além disso, colocar o cursor em uma palavra-chave de função realçará todos os retornos desse método (retornar, lançar). Isso também deve acontecer se você colocar o cursor em um retorno.
Renomeação instantânea
Pressione Ctrl-R/Command-R em uma variável local e você pode renomear o símbolo de forma síncrona no arquivo.
Refatoração
Você pode encontrar todos os usos de uma variável ou operação em um produto. Depois de localizar esses usos, você pode renomear todas as ocorrências da variável ou operação e refatorar todo o produto. Antes de realizar a refatoração, você pode visualizar as alterações em uma IU de tela dividida.
Para localizar e renomear todos os usos de uma variável ou operação:
Selecione uma ocorrência da variável ou operação no editor.
Selecione Editar-> Localizar usos (Alt-F7). Você tem a opção de pesquisar os comentários assim como o código ativo. A visualização Usos se abre, mostrando uma visualização em árvore de todos os usos da variável ou operação.
Selecione a variável no editor novamente e selecione Refatorar -> Renomear (Ctrl-R/Command-R). É aberta uma caixa de diálogo em que você digita o novo nome.
Clique em Visualização. A visualização Refatoração se abre com uma visualização em árvore das substituições à esquerda e uma tela dividida do arquivo original e refatorado à direita.
Você pode optar por não renomear a variável ou operação em lugares individuais. Cancele a seleção da renomeação individual na visualização em árvore à esquerda.
Após a revisão, clique em Refatorar e o IDE refatora todos os arquivos.
Correções rápidas e verificações de semântica
O IDE realiza muitas verificações de semântica no código JavaScript e oferece correções rápidas. Para exibir as correções rápidas, selecione Código-fonte -> Corrigir código (Alt-Enter). As verificações de semântica incluem:
Reatribuindo um parâmetro
A função anônima nem sempre retorna um valor
A variável oculta o argumento
O código que não possui efeitos colaterais (sem chamadas, sem atribuições)
Uma atribuição em uma condicional (se x = y). Esse erro de semântica possui várias correções rápidas associadas a ele, tal como a conversão para uma expressão ==, e a adição de parâmetros duplos para desativar o aviso.
Retornos inconsistentes de uma função (onde algumas expressões de retorno retornam um valor e outras não)
Lista de tarefas
O analisador de segundo plano e as correções rápidas de aviso são integradas com a lista de tarefas. Abra a lista de tarefas (Janela -> Lista de tarefas) para ver os erros em qualquer um dos arquivos associados ao JavaScript. Clique duas vezes em uma tarefa nessa lista e o editor vai para a linha relevante.
Auto-completar de código e análise de tipo
O auto-completar de código JavaScript lhe dá a opção de as classes principais de JavaScript incluídas no IDE inserir seu código. Por exemplo, você pode escrever
x = "foo"; y = x; y.
e o auto-completar de código mostrará os métodos disponíveis para strings JavaScript. O auto-completar de código funciona com todos os tipos de literal no JavaScript. A análise de tipo e o maquinário do auto-completar de código também conhecem sobre classes de estilo de protótipo (somente funções regulares) e o novo operador para construí-las.
O NetBeans IDE consulta parâmetros de tipo para parâmetros de função e tipos de retorno (@type, @param). Esses tipos são mostrados no auto-completar de código: na lista, na documentação e nas dicas do parâmetro (Ctrl-P). Os tipos de retorno também são mostrados na caixa de diálogo de auto-completar de código depois do nome da função, separados por um ponto-e-vírgula.
Se você marcar um método com @deprecated, ele é realçado no navegador e nas chamadas de auto-completar de código a esse método. A descrição substituída acompanhante é mostrada em uma seção separada na documentação do auto-completar de código com um segundo plano realçado.
O NetBeans IDE também pode determinar o tipo de retorno para muitas funções. Essa função é essencial para suporte a JSQuery. Por exemplo, os métodos que retornam verdadeiro ou falso possuem um tipo de retorno Booleano, aqueles que retornam números literais possui um tipo de retorno Número, etc. O IDE infere os tipos e controla explicitamente os tipos declarados por meio de comentários. A implicação mais importante é que o IDE segue os tipos através das chamadas. Se você possui código como este:
O NetBeans primeiro vê que foo é uma String, portanto, ele procura na classe String pelo método big(). A função charCodeAt(50) nessa String é o tipo Número, portanto, se você aplicar auto-completar de código em "to" aqui, verá somente os métodos disponíveis em Número.
Observação: Procurar tipos de retorno envolve uma consulta ao índice, o que pode levar tempo, portanto, durante a análise de tipo, o IDE observa o relógio e depois de passar um ou dois segundos. ele aborta a computação. Isso pode ser relevante para funções grandes, ou computadores lentos, ou computadores rápidos sob uma carga de trabalho pesada.
Ir para declaração
Pressione Ctrl e mantenha o cursor sobre uma linha de código. Clique com o botão esquerdo do mouse no nome da variável. Quando o IDE não sabe o tipo da sua variável (e, portanto, a função de destino) ele lhe oferece um menu popup de todas as declarações das variáveis do seu projeto:
Documentação
Auto-completar de código mostra a documentação das APIs javascript principais e das APIs DOM. Você também pode ver a documentação das suas próprias funções. Ctrl-apontar para as chamadas também mostra a documentação (como uma dica de ferramenta).
Conclusão incorporada
O auto-completar de código nos ids de elemento no HTML funciona para a função Prototype.js $("..."). Para ver o auto-completar de código em ids de elemento, pressione Ctrl-Espaço nos pontos de interrogação. Por exemplo, se você adicionar a variável = $("f|") e pressionar Ctrl-Espaço com o cursor (|) imediatamente depois do f, o auto-completar de código mostrará os ids de elemento HTML no documento que começa com f.
Compatibilidade de navegador
Você pode escolher quais navegadores deseja aceitar com seu JavaScript. O IDE sublinha as opções de auto-completar de código que não são aceitas nos navegadores selecionados.
Para selecionar os navegadores que você deseja aceitar:
Abra Ferramentas -> Opções/Preferências.
Clique no ícone Miscelânea. Uma página de abas se abre.
Abra a aba JavaScript.
Selecione e cancele a seleção de navegadores e versões.
Observe também que a documentação mostra ícones para cada navegador que aceita o elemento API documentado.
Na caixa de diálogo de auto-completar de código seguinte, o IDE sublinhou várias opções porque elas não tem suporte no navegador escolhido (somente Opera).
Incorporando
Os recursos de edição de JavaScript funcionam para JavaScript incorporado em arquivos RHTML, HTML e JSP.
Tipo aberto
Pressione Ctrl-O/Command-O e salte rapidamente para qualquer uma das suas funções, entre arquivos.
Suporte a JSDoc
Se você anotar um método com @private, ele aparece no navegador com um ícone de cadeado. Se você anotar uma função com @constructor ela é mostrada como um construtor (e incluída no auto-completar de código depois da palavra-chave "new" ), e você pode usar @class e @namespace para atribuir explicitamente as funções a determinadas classes (embora o analisador de tipo quase sempre possa atribuir essas funções automaticamente). As funções marcadas com @ignore não aparecem no auto-completar de código, mas são incluídas no índice e podem ser usadas em Ir para declaração.
Filtragem básica de inclusão de arquivo
Auto-completar de código em HTML só inclui código dos arquivos JavaScript referenciados. Considere um projeto em que o arquivo foo.js define a função foo() e o arquivo bar.js define a função bar(). Se o arquivo hello.html incluir somente <script src="bar.js"></script>, somente a função bar() é mostrada no auto-completar de código para hello.html.
Para enviar comentários e sugestões, obter suporte e se manter informado sobre os mais recentes desenvolvimentos dos recursos de desenvolvimento de Java EE do NetBeans IDE, inscreva-se na lista de endereçamento de .