# `native`

The standard Jsonic syntax only supports standard JSON value keywords: true, false, null.

Wouldn't it be nice to have undefined, Infinity, NaN as well? And while we're at it, how about recognizing literal /regexp/ syntax, and ISO (2021-03-19T17:15:51.845Z) dates?

The native plugin will do this for you!

This is a good plugin to copy and extend if you just want to add some "magic" values to your source data.

# Usage

To use the plugin, require or import the module path: jsonic/plugin/native:

// Node.js
let { Native } = require('jsonic/plugin/native')

// Web
import { Native } from 'jsonic/plugin/native'

(The convention for loading modules that are Jsonic plugins is to deconstruct: { PluginName } )

Once loaded, parse your source data as normal.

# Quick example

let { Native } = require('jsonic/plugin/native') // or import
let extra = Jsonic.make().use(Native)
extra('a:NaN') // === {"a": NaN}

# Syntax

The standard Jsonic syntax remains available, with the following extensions:

# Native value keywords

undefined
NaN
Infinity (optional prefix + or -)

# Regular Expressions

Characters between '/' and '/' are converted to a RegExp object.

/a/ // === new RegExp('a')
/\//g // === new RegExp('\/','g')

# ISO Dates

Unquoted text that matches the ISO date format is converted into a Date object.

when: 2021-03-19T17:15:51.845Z // == new Date('2021-03-19T17:15:51.845Z')

# Options

This plugin has no options.

# Implementation

The source code for this plugin is here: plugin/native.ts.

TODO - discuss

csv →

# native