Class Browser

Navegador

Essa classe fornece acesso a caixas de diálogo específicas do Google Planilhas.

Os métodos dessa classe só podem ser usados no contexto de uma planilha do Google. Em vez disso, use as caixas de diálogo do Google Workspace.

Consulte também

• ButtonSet

Propriedades

Propriedade	Tipo	Descrição
Buttons	ButtonSet

Métodos

Método	Tipo de retorno	Breve descrição
inputBox(prompt)	String|null	Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(prompt, buttons)	String|null	Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(title, prompt, buttons)	String|null	Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
msgBox(prompt)	String|null	Mostra uma caixa de diálogo com a mensagem fornecida e um botão "OK" no navegador do usuário.
msgBox(prompt, buttons)	String|null	Mostra uma caixa de diálogo com a mensagem fornecida e os botões especificados no navegador do usuário.
msgBox(title, prompt, buttons)	String|null	Mostra uma caixa de diálogo com o título, a mensagem e os botões especificados no navegador do usuário.

Documentação detalhada

inputBox(prompt)

Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.

O método inputBox mostra uma caixa de entrada do lado do cliente que exibe o prompt fornecido ao usuário. Essa função faz com que o script do lado do servidor seja suspenso. Ele é retomado automaticamente depois que o usuário fecha a caixa de diálogo, mas as conexões JDBC não persistem durante a suspensão.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');

Esse método não é recomendado. Em vez disso, use um prompt de interface.

Parâmetros

Nome	Tipo	Descrição
prompt	String	O texto a ser mostrado na caixa de diálogo.

Retornar

String|null — O texto inserido pelo usuário (ou "cancelar" para uma caixa de diálogo cancelada ou dispensada).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

inputBox(prompt, buttons)

Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.

O método inputBox mostra uma caixa de entrada do lado do cliente que exibe o prompt fornecido ao usuário e oferece uma opção de botões a serem mostrados. Essa função faz com que o script do lado do servidor seja suspenso. Ele é retomado automaticamente depois que o usuário fecha a caixa de diálogo, mas as conexões JDBC não persistem durante a suspensão.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);

Esse método não é recomendado. Em vez disso, use um prompt de interface.

Parâmetros

Nome	Tipo	Descrição
prompt	String	O texto a ser mostrado na caixa de diálogo.
buttons	ButtonSet	O tipo de conjunto de botões a ser usado.

Retornar

String|null — O texto inserido pelo usuário (ou "cancelar" para uma caixa de diálogo cancelada ou dispensada).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

inputBox(title, prompt, buttons)

Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.

O método inputBox mostra uma caixa de entrada do lado do cliente com o título fornecido, que exibe o prompt fornecido ao usuário e oferece uma opção de botões a serem mostrados. Essa função faz com que o script do lado do servidor seja suspenso. Ele é retomado automaticamente depois que o usuário fecha a caixa de diálogo, mas as conexões JDBC não persistem durante a suspensão.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);

Esse método não é recomendado. Em vez disso, use um prompt de interface.

Parâmetros

Nome	Tipo	Descrição
title	String	O título da caixa de diálogo.
prompt	String	O texto a ser mostrado na caixa de diálogo.
buttons	ButtonSet	O tipo de conjunto de botões a ser usado.

Retornar

String|null — O texto inserido pelo usuário (ou "cancelar" para uma caixa de diálogo cancelada ou dispensada).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(prompt)

Mostra uma caixa de diálogo com a mensagem fornecida e um botão "OK" no navegador do usuário.

O método msgBox mostra uma caixa de mensagem do lado do cliente que exibe a mensagem fornecida ao usuário. Esse método faz com que o script do lado do servidor seja suspenso. Ele é retomado automaticamente depois que o usuário fecha a caixa de diálogo, mas as conexões JDBC não persistem durante a suspensão.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');

Esse método não é recomendado. Em vez disso, use uma caixa de diálogo de alerta da interface.

Parâmetros

Nome	Tipo	Descrição
prompt	String	O texto a ser mostrado na caixa de diálogo.

Retornar

String|null — O texto em letras minúsculas do botão clicado pelo usuário (ou 'cancelar' para uma caixa de diálogo dispensada).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(prompt, buttons)

Mostra uma caixa de diálogo com a mensagem fornecida e os botões especificados no navegador do usuário.

O método msgBox mostra uma caixa de mensagem do lado do cliente que exibe a mensagem fornecida ao usuário e oferece uma opção de botões a serem mostrados. Esse método faz com que o script do lado do servidor seja suspenso. Ele é retomado automaticamente depois que o usuário fecha a caixa de diálogo, mas as conexões JDBC não persistem durante a suspensão.

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);

Esse método não é recomendado. Em vez disso, use uma caixa de diálogo de alerta da interface.

Parâmetros

Nome	Tipo	Descrição
prompt	String	O texto a ser mostrado na caixa de diálogo.
buttons	ButtonSet	O tipo de conjunto de botões a ser usado.

Retornar

String|null — O texto em letras minúsculas do botão clicado pelo usuário (ou 'cancelar' para uma caixa de diálogo dispensada).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets

---

msgBox(title, prompt, buttons)

Mostra uma caixa de diálogo com o título, a mensagem e os botões especificados no navegador do usuário.

O método msgBox mostra uma caixa de mensagem do lado do cliente com o título fornecido, que exibe a mensagem fornecida ao usuário e oferece uma opção de botões a serem mostrados. Esse método faz com que o script do lado do servidor seja suspenso. Ele é retomado automaticamente depois que o usuário fecha a caixa de diálogo, mas as conexões JDBC não persistem durante a suspensão.

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);

Esse método não é recomendado. Em vez disso, use uma caixa de diálogo de alerta da interface.

Parâmetros

Nome	Tipo	Descrição
title	String	O título da caixa de diálogo.
prompt	String	O texto a ser mostrado na caixa de diálogo.
buttons	ButtonSet	O tipo de conjunto de botões a ser usado.

Retornar

String|null — O texto em letras minúsculas do botão clicado pelo usuário (ou 'cancelar' para uma caixa de diálogo dispensada).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

• https://www.googleapis.com/auth/spreadsheets.currentonly
• https://www.googleapis.com/auth/spreadsheets