Compartilhar via


Executar fragmentos de JavaScript em qualquer página Web

Se estiver a introduzir o mesmo código na ferramenta Consola repetidamente, considere guardar o código como um fragmento e, em seguida, executar o fragmento. Os fragmentos são scripts que cria na ferramenta Origens . Os fragmentos têm acesso ao contexto JavaScript da página Web e pode executar fragmentos em qualquer página Web. Os fragmentos podem ser utilizados para alterar uma página Web, como para alterar o respetivo conteúdo ou aspeto, ou para extrair dados.

A seguinte captura de ecrã mostra o Microsoft Edge com uma página Web à esquerda e DevTools à direita. A ferramenta Origens está aberta, apresentando o código fonte do fragmento selecionado no separador Fragmentos . O código do fragmento foi executado e efetuou alterações à página Web:

A página Web, alterada pelo fragmento

O código fonte do fragmento é apresentado abaixo:

// Change the background color to "dimgrey".
document.body.style.backgroundColor = "dimgrey";

// Add a paragraph at the bottom of the document.
const p = document.createElement("p");
p.textContent = "Hello world";
p.style.color = "white";
p.style.fontSize = "2rem";
document.body.appendChild(p);

// Log a message to the console.
console.log("Hello world");

O código altera a cor de fundo da página Web para dimgrey, adiciona uma nova linha de texto na parte inferior da página Web e regista uma mensagem na ferramenta Consola .

Quando executa um fragmento numa página Web, o código fonte do fragmento é adicionado à página Web atual. Para obter mais informações sobre como alterar o código existente de uma página Web em vez de adicionar novo código, consulte Substituir recursos de página Web com cópias locais (separador Substituições).

Incluir todo o seu código num único ficheiro

As definições de segurança da maioria das páginas Web bloqueiam o carregamento de outros scripts em fragmentos. Por este motivo, tem de incluir todo o seu código num único ficheiro.

Abrir o separador Fragmentos

O separador Fragmentos está agrupado com o separador Página no painel Navegador , à esquerda da ferramenta Origens .

Para abrir o separador Fragmentos :

  1. Para abrir o DevTools, clique com o botão direito do rato na página Web e, em seguida, selecione Inspecionar. Em alternativa, prima Ctrl+Shift+I (Windows, Linux) ou Comando+Opção+I (macOS). O DevTools é aberto.

  2. Em DevTools, na Barra de Atividade, selecione o separador Origens . Se esse separador não estiver visível, clique no botão Mais ferramentas (ícone Mais ferramentas).

    A ferramenta Origens com o separador Página aberto à esquerda

  3. No painel Navegador (à esquerda), selecione o separador Fragmentos . Para aceder à opção Fragmentos , poderá ter de clicar no botão Mais separadores (Mais separadores).

Abrir o separador Fragmentos a partir do Menu de Comandos

Também pode abrir o separador Fragmentos com o Menu de Comandos:

  1. Selecione qualquer coisa em DevTools, para que o DevTools tenha o foco.

  2. Prima Ctrl+Shift+P (Windows, Linux) ou Comando+Shift+P (macOS) para abrir o Menu de Comandos.

  3. Comece a escrever "fragmentos", selecione Mostrar Fragmentos e, em seguida, prima Enter para executar o comando:

    O comando Mostrar Fragmentos

Criar um novo fragmento

Para criar um novo fragmento a partir do separador Fragmentos :

  1. Abra o separador Fragmentos.

  2. Clique em Novo fragmento (+).

  3. Introduza um nome para o fragmento e, em seguida, prima Enter:

    Um fragmento novo, vazio na ferramenta Origens

Criar um novo fragmento a partir do Menu de Comandos

  1. Concentre o cursor algures no DevTools.

  2. Prima Ctrl+Shift+P (Windows, Linux) ou Comando+Shift+P (macOS) para abrir o Menu de Comandos.

  3. Comece a escrever "fragmento", selecione Criar novo fragmento e, em seguida, prima Enter:

    O comando para criar um novo fragmento

Para mudar o nome do novo fragmento, consulte Mudar o nome de um fragmento, abaixo.

Editar um fragmento

Para editar o código fonte de um fragmento:

  1. Abra o separador Fragmentos.

  2. No separador Fragmentos , clique no nome do fragmento que pretende editar. O fragmento é aberto no código Editor:

    O código Editor

  3. Utilize o code Editor para adicionar JavaScript ao seu fragmento.

  4. Quando um asterisco é apresentado junto ao nome do fragmento, significa que tem código não guardado. Prima Ctrl+S (Windows, Linux) ou Comando+S (macOS) para guardar:

    Um asterisco junto ao nome do fragmento indica código não guardado

Executar um fragmento

Executar um fragmento a partir da ferramenta Origens

  1. Abra o separador Fragmentos.

  2. Clique no nome do fragmento que pretende executar. O fragmento é aberto no código Editor:

  3. Clique no botão Executar fragmento (Executar fragmento) ou prima Ctrl+Enter (Windows, Linux) ou Comando+Enter (macOS):

    O botão executar fragmento na parte inferior do editor de código

Executar um fragmento a partir do Menu de Comandos

  1. Concentre o cursor algures no DevTools.

  2. Prima Ctrl+Shift+P (Windows, Linux) ou Comando+Shift+P (macOS) para abrir o Menu de Comandos.

  3. Elimine o > caráter e escreva o caráter ! seguido do nome do fragmento que pretende executar:

    Executar um fragmento a partir do Menu de Comandos

  4. Prima Enter para executar o fragmento.

Mudar o nome de um fragmento

  1. Abra o separador Fragmentos.

  2. Clique com o botão direito do rato no nome do fragmento e, em seguida, selecione Mudar o Nome.

Eliminar um fragmento

  1. Abra o separador Fragmentos.

  2. Clique com o botão direito do rato no nome do fragmento e, em seguida, selecione Remover.

Guardar um fragmento

Por predefinição, os fragmentos só estão disponíveis em DevTools, mas também pode guardá-los no disco.

  1. Abra o separador Fragmentos.

  2. Clique com o botão direito do rato no nome do fragmento e, em seguida, selecione Guardar como.

  3. Quando lhe for pedido, introduza um nome de ficheiro e uma localização.

Observação

Partes desta página são modificações baseadas no trabalho criado e partilhado pela Google e utilizado de acordo com os termos descritos na Licença Internacional Creative Commons Attribution 4.0. A página original é encontrada aqui e é da autoria de Kayce Bascos.

Licença Creative Commons Este trabalho é licenciado ao abrigo de uma Licença Internacional creative Commons Attribution 4.0.