Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes