Todos os produtos
Search
Central de documentação

SuperApp:JavaScript API

Última atualização: Jun 29, 2026

Lista as JSAPIs disponíveis para miniapps WindVane e o suporte às plataformas Android e iOS.

Básico

API

Descrição

Android

iOS

WVBase.copyToClipboard

Copia o texto especificado para a área de transferência.

Y

Y

WVBase.isInstall

Verifica se o aplicativo especificado está instalado.

Y

Y

WVBase.isAppsInstalled

Verifica se os aplicativos especificados estão instalados.

Y

Y

WVBase.notify

Dispara um evento no document com o nome e os parâmetros definidos.

N

Y

WVBase.openBrowser

Abre a URL especificada em uma nova janela do Safari.

N

Y

WVBase.setBackgroundColor

Defina a cor de fundo da WebView.

N

Y

WVBase.canIUse

Verifica se a versão atual oferece suporte à API especificada.

Y

Y

WVMiniApp.close

Fecha o miniapp.

Y

Y

Navegação

Parâmetro

Descrição

Android

iOS

WVNavigator.pop

Fecha a página atual.

Y

Y

WVNavigator.push

Abre uma nova página no miniapp.

Y

Y

Interação

API

Descrição

Android

iOS

WVUI.showLoadingBox

Exibe uma caixa de carregamento.

Y

Y

WVUI.hideLoadingBox

Oculta a caixa de carregamento.

Y

Y

WVUI.hideKeyboard

Oculta o teclado.

Y

Y

API

Descrição

Android

iOS

WVUIToast.toast

Exibe um toast — mensagem breve no centro da tela.

Y

Y

API

Descrição

Android

iOS

WVUIDialog.alert

Exibe um alerta.

Y

Y

WVUIDialog.confirm

Exibe uma caixa de diálogo de confirmação.

Y

Y

WVUIDialog.enableAlertBeforeUnload

Mostra uma caixa de diálogo de confirmação ao pressionar Voltar para fechar a página do miniapp.

Y

Y

WVUIDialog.disableAlertBeforeUnload

Desativa a caixa de diálogo de confirmação do botão Voltar.

Y

Y

WVUIDialog.prompt

Exibe uma caixa de diálogo para entrada de texto.

Y

Y

WVUIDialog.showAuthGuide

Exibe uma caixa de diálogo com texto e ilustrações para orientar o usuário na concessão de permissões.

Y

Y

WVUIDatePicker.show

Exibe um seletor de data. Usa a data atual como padrão caso nenhuma outra seja defina.

Y

Y

API

Descrição

Android

iOS

WVUIActionSheet.show

Exibe uma folha de ações na parte inferior da tela.

Y

Y

API

Descrição

Android

iOS

WVNavigationBar.update

Atualize a barra de navegação da página atual.

Y

Y

WVNavigationBar.getHeight

Obtém a altura da barra de navegação do miniapp.

Y

Y

Multimídia

API

Descrição

Android

iOS

WVImage.saveImage

Salva uma imagem de uma URL HTTP(S) ou string base64 no álbum.

Y

Y

API

Descrição

Android

iOS

WVVideo.chooseVideo

Grava um vídeo ou escolha um vídeo do álbum.

Y

Y

WVVideo.saveVideoToPhotosAlbum

Salva um vídeo no álbum do sistema.

Y

Y

API

Descrição

Android

iOS

WVAudio.playSystemSound

Reproduz o som do sistema especificado.

N

Y

API

Descrição

Android

iOS

WVCamera.takePhoto

Tira uma foto ou escolha uma do álbum. Oferece suporte a upload automático se o aplicativo nativo implementar o protocolo de upload.

Y

Y

WVCamera.confirmUploadPhoto

Confirme o upload da foto.

Y

Y

Cache

Parâmetro

Descrição

Android

iOS

WVStorage.setItem

Armazena dados de uma chave especificada no cache local.

Y

Y

WVStorage.getItem

Recupera os dados de uma chave especificada do cache local (assíncrono).

Y

Y

WVStorage.removeItem

Remove os dados de uma chave especificada do cache local.

Y

Y

WVStorage.clearStorage

Limpa o cache local (assíncrono).

Y

Y

WVStorage.clearStorageSync

Limpa o cache local (síncrono).

Y

Y

Arquivo

API

Descrição

Android

iOS

WVFile.write

Grava o conteúdo do arquivo em disco.

Y

Y

WVFile.read

Lê o conteúdo de um arquivo.

Y

Y

WVFile.getFileInfo

Obtém informações do arquivo.

Y

Y

WVFile.downloadFile

Baixa um arquivo localmente.

Y

Y

WVFile.uploadFile

Faz upload de um arquivo para uma URL de servidor.

Y

Y

WVFile.chooseFiles

Escolha um ou mais arquivos locais para upload.

Y

Y

WVFile.getDataByFilePath

Obtém os dados de um arquivo local pelo caminho.

Y

Y

Localização geográfica

Parâmetro

Descrição

Android

iOS

WVLocation.getLocation

Obtém a localização geográfica atual.

Compatível

Compatível

WVLocation.searchLocation

Pesquisa a latitude e longitude de um endereço.

Não compatível

Compatível

Cross-origin

Parâmetro

Descrição

Android

iOS

WVCookie.read

Lê todos os cookies de uma URL especificada.

Y

Y

WVCookie.write

Defina um cookie para uma URL especificada.

Y

Y

Dispositivo

Parâmetro

Descrição

Android

iOS

WVSystem.getSystemInfo

Obtém as informações do sistema do dispositivo.

Y

Y

WVSystem.getSystemInfoSync

Obtém sincronamente as informações do sistema do dispositivo.

Y

Y

Parâmetro

Descrição

Android

iOS

WVNativeDetector.isSimulator

Verifica se o ambiente atual é um simulador.

Y

Y

WVNativeDetector.getCurrentUsage

Obtém a utilização atual da CPU e o uso de memória.

Y

Y

WVNativeDetector.getDeviceYear

Obtém o ano de lançamento do dispositivo para estimativa de desempenho. Preciso no iOS; aproximado no Android.

Y

Y

WVNativeDetector.getModelInfo

Obtém informações do dispositivo, como o modelo.

Y

Y

WVNativeDetector.getSafeAreaInsets

Obtém as margens da área segura da página atual. Apenas para páginas em tela cheia.

N

Y

Parâmetro

Descrição

Android

iOS

WVNetwork.getNetworkType

Obtém o tipo de rede atual.

Y

Y

Parâmetro

Descrição

Android

iOS

WVScreen.getOrientation

Obtém a orientação atual da tela (paisagem ou retrato).

Y

Y

WVScreen.setOrientation

Defina a orientação atual da tela (paisagem ou retrato).

Y

Y

WVScreen.setScreenBrightness

Defina o brilho da tela.

Y

Y

WVScreen.getScreenBrightness

Obtém o brilho da tela.

Y

Y

Parâmetro

Descrição

Android

iOS

WVScreenCapture.capture

Captura uma imagem da área visível da WebView.

Y

Y

Parâmetro

Descrição

Android

iOS

WVMotion.listenBlow

Inicia o monitoramento de gestos de sopro.

Y

Y

WVMotion.stopListenBlow

Para o monitoramento de gestos de sopro.

Y

Y

WVMotion.listenGyro

Ativa ou desativa o monitoramento do giroscópio.

Y

Y

WVMotion.listeningShake

Ativa ou desativa o monitoramento do gesto de agitar.

Y

Y

WVMotion.vibrate

Faz o dispositivo vibrar.

Y

Y

WVMotion.startAccelerometer

Inicia o monitoramento de dados de aceleração.

Y

Y

WVMotion.stopAccelerometer

Para o monitoramento de dados de aceleração.

Y

Y

WVMotion.startCompass

Inicia o monitoramento de dados da bússola.

Y

Y

WVMotion.stopCompass

Para o monitoramento de dados da bússola.

Y

Y

Parâmetro

Descrição

Android

iOS

WVNotification.beep

Emite um bipe no dispositivo.

Y

Y

Parâmetro

Descrição

Android

iOS

WVCall.dial

Abre o discador.

Y

Y

WVCall.call

Realiza uma chamada telefônica diretamente.

Y

Y

Parâmetro

Descrição

Android

iOS

WVApplication.appState

Obtém o estado atual do aplicativo (primeiro plano ou segundo plano).

N

Y

WVApplication.getNotificationSettings

Obtém as configurações de notificação do aplicativo.

N

Y

WVApplication.openSettings

Abre a página de configurações do aplicativo atual.

N

Y

Parâmetro

Descrição

Android

iOS

WVContacts.askAuth

Solicita permissão para acessar contatos.

N

Y

WVContacts.authStatus

Obtém o status atual da permissão para acessar contatos.

N

Y

WVContacts.choose

Abre a lista de contatos e retorna o nome e o número de telefone do contato escolha.

Y

Y

WVContacts.find

Pesquisa contatos por nome e número de telefone.

Y

Y

WVContacts.addPhoneContact

Adiciona um contato.

Y

Y

Parâmetro

Descrição

Android

iOS

WVScan.scan

Inicia o leitor de código.

Y

Y

Parâmetro

Descrição

Android

iOS

WVBattery.getBatteryInfo

Obtém o nível da bateria de forma assíncrona.

Y

Y

WVBattery.getBatteryInfoSync

Obtém o nível da bateria de forma síncrona.

Y

Y

Parâmetro

Descrição

Android

iOS

WVBluetooth.requestAuthorization

Solicita permissões de Bluetooth e ativa o Bluetooth.

Y

Y

WVBluetooth.scan

Busca dispositivos Bluetooth Low Energy (BLE) próximos.

Y

Y

WVBluetooth.stopScan

Para a busca de dispositivos BLE.

Y

Y

WVBluetooth.connect

Conecta-se a um dispositivo BLE no endereço especificado.

Y

Y

WVBluetooth.disconnect

Desconecta-se de um dispositivo BLE conectado.

Y

Y

WVBluetooth.getServices

Descobre serviços em um dispositivo BLE conectado.

Y

Y

WVBluetooth.getCharacteristics

Descobre as características de um serviço especificado.

Y

Y

WVBluetooth.writeValue

Grava um valor em uma característica especificada de um dispositivo BLE conectado.

Y

Y

WVBluetooth.readValue

Lê o valor de uma característica especificada de um dispositivo BLE conectado.

Y

Y

WVBluetooth.startNotifications

Ativa notificações para alterações de valor de uma característica.

Y

Y

WVBluetooth.stopNotifications

Desativa notificações para alterações de valor de uma característica.

Y

Y

Comunicação

API

Descrição

Android

iOS

WVStandardEventCenter.postNotificationToNative

Envia um evento nomeado do miniapp para o aplicativo nativo. O nome do evento pode ser qualquer nome acordado com a equipe nativa.

Y

Y

Outros recursos

API

Descrição

Android

iOS

WindVaneReady

Disparado quando uma página termina de carregar. Escute o evento WindVaneReady para verificar o status de carregamento.

Y

Y

Background

Dispara o evento WV.Event.APP.Background quando o aplicativo vai para o segundo plano (usuário troca de aplicativo ou abre a central de notificações).

Y

Y

Active

Dispara o evento WV.Event.APP.Active quando o aplicativo retorna do segundo plano.

Y

Y