firestore-parser

KO | EN

gitlite — search

#python #typescript #javascript #php #rust #docker #image-processing #react #backend #java #game #reactjs

firestore-parser

★ 76 Open GitHub ↗

Parse the Firestore REST API JSON into a useable JS object

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# firestore-parser &middot; [![Maintainability](https://api.codeclimate.com/v1/badges/c021344dfe81edfce992/maintainability)](https://codeclimate.com/github/jdbence/firestore-parser/maintainability) [![Test Coverage](https://api.codeclimate.com/v1/badges/c021344dfe81edfce992/test_coverage)](https://codeclimate.com/github/jdbence/firestore-parser/test_coverage) [![npm version](https://img.shields.io/npm/v/firestore-parser.svg?style=flat)](https://www.npmjs.com/package/firestore-parser) [![npm license](https://img.shields.io/npm/l/firestore-parser.svg?style=flat)](https://www.npmjs.com/package/firestore-parser)

Parse the [Firestore REST API](https://firebase.google.com/docs/firestore/reference/rest/) JSON into a useable JS object

## Installation

```
  // Install with NPM
  npm install firestore-parser --save
  // or Install with Yarn
  yarn add firestore-parser
```

## Examples
[Live Example](https://repl.it/@jdbence/firestore-parser-example-01)
```JS
  // Node/AMD: 
  // const FireStoreParser = require('firestore-parser');
  // Node with TypeScript:
  // import * as FireStoreParser from 'firestore-parser';
  import FireStoreParser from 'firestore-parser'
  const projectID = 'PROJECT_ID'
  const key = 'API_KEY'
  const doc = 'DOCUMENT'
  const url = `https://firestore.googleapis.com/v1beta1/projects/${projectID}/databases/(default)/documents/${doc}?key=${key}`
  
  fetch(url)
    .then(response => response.json())
    .then(json => FireStoreParser(json))
    .then(json => console.log(json));
```

### Data Structure

The Firestore JSON returned in the REST API, uses value type as keys. This can be difficult to work with since you have to know the data type prior getting the value. The `firestore-parser` removes this barrier for you.
#### JSON response from Firestore
```
{
	"player": {
		"mapValue": {
			"fields": {
				"name": {
					"stringValue": "steve"
				},
				"health": {
					"integerValue": "100"
				},
				"alive": {
					"booleanValue": true
				}
			}
		}
	},
	"level": {
		"integerValue": "7"
	}
}
```
#### JSON parsed with firestore-parser
```
{
	"player": {
		"name": "steve",
		"health": 100,
		"alive": true
	},
	"level": 7
}
```

firestore-parser

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README