Código Inline

Escreva Node.js ou Python direto no editor da etapa de Regra Customizada: a API do Mini SDK (bm) e o que está disponível em cada linguagem.

Configurando a etapa

O editor abre expandido quando a etapa já tem script. Sem script, ele fica recolhido: clique em ▼ Mostrar para abrir.

No bloco Código Customizado da etapa de 🔢 Regra Customizada:

Erros de sintaxe e avisos: o aviso vem antes da execução

Uma chave a mais, uma aspa aberta ou uma indentação fora do lugar derrubam o script inteiro, e sem aviso o erro só apareceria no meio da execução, depois de outras etapas já terem rodado. Por isso o browserMate confere o código do Script Inline e do Script de Sessão, e separa o que encontra em dois níveis:

• Erro (vermelho): o script não roda. Além do sublinhado no editor, a etapa entra no indicador de pendências, na categoria Script com erro de sintaxe, com a linha e a descrição. Enquanto houver pendência, o botão de publicar não aparece (veja Pendências). Salvar continua liberado: dá para guardar um script pela metade e voltar depois. No Debug, ao clicar em Debugar com um erro desses, o browserMate mostra a lista e pergunta se você quer rodar mesmo assim.
• Aviso (amarelo): o código é válido, mas alguma coisa nele vai falhar se aquela linha executar, como uma variável que nunca foi declarada. Aparece só no editor e não impede publicar, porque o script pode estar certo de um jeito que o editor não consegue enxergar.

No editor, a linha fica sublinhada e uma faixa abaixo dele mostra Linha N com a descrição, mais o número de outros achados. Clique na faixa para ir até a linha. A conferência acontece alguns instantes depois de você parar de digitar.

O que é erro (vermelho)

O que é aviso (amarelo)

A conferência vale só para o modo Inline. O código de um Projeto ZIP não fica no cadastro da etapa e não é conferido.

Node.js inline

O código roda em Node.js 24, embarcado no runtime. Veja Versões de Node.js e Python.

O código é executado em um contexto Node.js com o Mini SDK bm já disponível (o runtime injeta const bm = require('./browsermate') automaticamente antes do seu código). As variáveis do processo vivem no globalData e são acessadas pela chave no formato {variavel}, com chaves.

Acesso a variáveis

// Ler variável do processo. A chave usa o formato {variavel}
const valor = bm.get('{nome_variavel}');
// com valor padrão caso não exista
const tipo  = bm.get('{tipo_documento}', 'NFe');
// todas as variáveis de uma vez (somente leitura)
const todas = bm.globalData;

// Escrever variáveis: SEMPRE via bm.done() ao final do script
bm.done('ok', {
  '{resultado}': 'texto calculado',
  '{total}':     1500.75,
  '{lista}':     [1, 2, 3]
});

Módulos disponíveis

O runtime Node.js suporta require() para módulos nativos e para dependências pré-instaladas:

const fs      = require('fs');
const path    = require('path');
const crypto  = require('crypto');
const https   = require('https');
const Buffer  = require('buffer').Buffer;
const xml2js  = require('xml2js');   // parsing XML
const xlsx    = require('xlsx');     // Excel
const moment  = require('moment');  // datas

Logging

Use bm.bmLog() para registrar mensagens nos logs oficiais de execução, que aparecem no Control Room:

bm.bmLog('Processando item: ' + bm.get('{item_atual}'));
bm.bmLog('Total de itens: ' + lista.length);
bm.bmLog('Erro ao processar: ' + err.message);

Código assíncrono

O runtime suporta async/await. Envolva o código em uma função assíncrona auto-executável e chame bm.done() ao final:

(async () => {
  const axios = require('axios');

  // Buscar dados de uma API externa
  const id   = bm.get('{id}');
  const resp = await axios.get(`https://api.exemplo.com/item/${id}`);

  bm.bmLog('Item carregado: ' + resp.data.nome);

  bm.done('ok', {
    '{nome_item}':  resp.data.nome,
    '{preco_item}': resp.data.preco
  });
})();

Python inline

O código roda em Python 3.14, embarcado no runtime, com pip disponível. Veja Versões de Node.js e Python.

O código é executado em um ambiente Python 3 com o Mini SDK bm já disponível (o runtime injeta import browsermate as bm automaticamente antes do seu código). As variáveis usam o mesmo formato de chave {variavel}.

Acesso a variáveis

# Ler variável do processo. A chave usa o formato {variavel}
valor = bm.get('{nome_variavel}')
lista = bm.get('{lista}', [])

# Escrever variáveis: SEMPRE via bm.done() ao final do script
bm.done('ok', {
    '{resultado}': 'texto calculado',
    '{total}':     1500.75,
    '{lista}':     [1, 2, 3]
})

Bibliotecas disponíveis

import json, re, os, sys, math, datetime
import base64, hashlib, hmac
import csv, io
import xml.etree.ElementTree as ET
import urllib.request, urllib.parse
import pandas as pd       # análise de dados
import openpyxl           # Excel
import PyPDF2             # PDF

Logging em Python

Use bm.bmLog() para registrar mensagens nos logs oficiais de execução, que aparecem no Control Room:

bm.bmLog('Processando...')
bm.bmLog('Total de itens: ' + str(len(lista)))

API de contexto do processo

Além das variáveis, o runtime expõe outras utilidades:

Exemplos práticos

Calcular impostos sobre um valor

const valor_bruto  = parseFloat(bm.get('{valor_bruto}')) || 0;
const aliquota_iss = 0.05;  // 5%
const aliquota_pis = 0.0065;

const valor_iss = valor_bruto * aliquota_iss;
const valor_pis = valor_bruto * aliquota_pis;

bm.done('calculado', {
  '{valor_iss}':     valor_iss.toFixed(2),
  '{valor_pis}':     valor_pis.toFixed(2),
  '{valor_liquido}': (valor_bruto - valor_iss - valor_pis).toFixed(2)
});

Parsear XML de NF-e

const xml2js  = require('xml2js');
const xml_nfe = bm.get('{xml_nfe}', '');

(async () => {
  const resultado = await xml2js.parseStringPromise(xml_nfe, { explicitArray: false });
  const nfe = resultado.nfeProc?.NFe?.infNFe;

  const numero = nfe?.ide?.nNF || '';
  bm.bmLog('NF-e parseada: ' + numero);

  bm.done('ok', {
    '{numero_nf}':      numero,
    '{valor_total}':    nfe?.total?.ICMSTot?.vNF || '0',
    '{cnpj_emitente}':  nfe?.emit?.CNPJ || ''
  });
})();

Gerar CSV e salvar em variável

import csv, io, base64

itens = bm.get('{lista_itens}', [])

output = io.StringIO()
writer = csv.DictWriter(output, fieldnames=['produto', 'qty', 'preco'])
writer.writeheader()
writer.writerows(itens)

csv_texto = output.getvalue()
# Codifica em base64 para armazenar na variável
bm.done('csv gerado', {
    '{csv_base64}': base64.b64encode(csv_texto.encode()).decode()
})