README.md

denormalizr

Denormalizr takes an entity normalized by normalizr, and returns its complete tree including all the referred entities.

This module is useful when consuming normalized data, e.g. from mapStateToProps in a redux connect(). While normalizr is great on making data consistent between the app, reassembling an entity can be a tedious work. Denormalizr can help!

If you are using Immutable data, try denormalizr-immutable.

Installation

npm install denormalizr --save

Usage

import { denormalizer } from "denormalizr";
const denormalized = denormalizer(entity, entities, entitySchema);

Example

import { denormalize } from "denormalizr";
const articleSchema = new Schema('articles');
const userSchema = new Schema('users');

articleSchema.define({
  author: userSchema
});

const response = {
  articles: [{
    id: 1,
    title: 'Some Article',
    author: {
      id: 1,
      name: 'Dan'
    },
  }, {
    id: 2,
    title: 'Other Article',
    author: {
      id: 1,
      name: 'Dan'
    }
  }]
};

const normalized = normalize(response, {
  articles: arrayOf(articleSchema)
});

const article = normalized.entities.articles[0];
console.log(article);
// {
//   id: 1,
//   title: 'Some Article',
//   author: '1'
// }

const denormalized = denormalize(article, normalized.entities, articleSchema);
console.log(denormalized);
// {
//   id: 1,
//   title: 'Some Article',
//   author: {
//     id: 1,
//     name: 'Dan'
//   },
// }