CKTIS / JavaScript
Pipelines de processamento de dados
Um pipeline de processamento de dados liga as etapas de leitura, validação, filtragem, transformação e escrita. Na troca de JSON, as referências a grafos e a codificação correta dos caminhos exigem atenção separada.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
JSON.stringify(JSON.parse(text).filter(predicate).map(transform))Um pipeline de processamento de dados passa o resultado de cada etapa à seguinte: ler → validar → selecionar → transformar → escrever. No exemplo, JSON.parse lê o texto, filter seleciona registos, map define a sua forma e JSON.stringify produz o resultado JSON. Define o contrato de entrada de cada etapa; uma análise sintática bem-sucedida, por si só, não valida um esquema de dados.
filter e map em arrays são eager e criam arrays de resultados; isto não é um pipeline de fluxo. Não fazem uma cópia profunda dos objetos aninhados. Evita mutações nos callbacks e trata os erros de forma deliberada. O exemplo verifica apenas se a entrada é um array; dados não fiáveis também precisam de validação dos registos. As funcionalidades da linguagem utilizadas são compatíveis com ECMAScript 2015; o exemplo não requer Web APIs nem infere o respetivo suporte nos browsers a partir do Node 24.
Referências a grafos e caminhos com caracteres de escape em JSON (Graph references and escaped paths in JSON). JSON não preserva a identidade de objetos partilhados; sem conversão especial, JSON.stringify rejeita ciclos com um TypeError. Aqui, nextId é um campo normal do formato escolhido, não uma referência resolvida automaticamente. Após a filtragem, pode apontar para um registo removido: decide se deves manter, remover ou rejeitar essa referência. O exemplo mantém-na deliberadamente.
Um caminho é texto, não uma instrução para aceder a um ficheiro. No texto JSON, uma barra invertida escreve-se \\; JSON.parse restaura um único carácter. Um literal JavaScript tem a sua própria camada de escape. Usa JSON.stringify em vez de concatenar JSON manualmente. O escape não valida um caminho nem o torna seguro.
Exemplos
const text = JSON.stringify([
{ id: "a", active: true, path: "C:\\data\\a.json", nextId: "b" },
{ id: "b", active: false, path: "C:\\data\\b.json", nextId: "a" }
]);
const rows = JSON.parse(text);
if (!Array.isArray(rows)) throw new TypeError("Expected array");
const result = rows
.filter(row => row.active === true)
.map(row => ({ id: row.id, path: row.path, nextId: row.nextId }));
console.log(JSON.stringify(result));Resultado
[{"id":"a","path":"C:\\data\\a.json","nextId":"b"}]O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.