Numerous Problems Multiplied
    Have ideas to improve npm?Join in the discussion! »

    yaml
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/yaml package

    1.10.2 • Public • Published

    YAML

    yaml is a JavaScript parser and stringifier for YAML, a human friendly data serialization standard. It supports both parsing and stringifying data using all versions of YAML, along with all common data schemas. As a particularly distinguishing feature, yaml fully supports reading and writing comments and blank lines in YAML documents.

    The library is released under the ISC open source license, and the code is available on GitHub. It has no external dependencies and runs on Node.js 6 and later, and in browsers from IE 11 upwards.

    For the purposes of versioning, any changes that break any of the endpoints or APIs documented here will be considered semver-major breaking changes. Undocumented library internals may change between minor versions, and previous APIs may be deprecated (but not removed).

    For more information, see the project's documentation site: eemeli.org/yaml/v1

    To install:

    npm install yaml

    Note: This is yaml@1. You may also be interested in the next version, currently available as yaml@next.

    API Overview

    The API provided by yaml has three layers, depending on how deep you need to go: Parse & Stringify, Documents, and the CST Parser. The first has the simplest API and "just works", the second gets you all the bells and whistles supported by the library along with a decent AST, and the third is the closest to YAML source, making it fast, raw, and crude.

    import YAML from 'yaml'
    // or
    const YAML = require('yaml')

    Parse & Stringify

    YAML Documents

    import { Pair, YAMLMap, YAMLSeq } from 'yaml/types'

    CST Parser

    import parseCST from 'yaml/parse-cst'

    YAML.parse

    # file.yml
    YAML:
      - A human-readable data serialization language
      - https://en.wikipedia.org/wiki/YAML
    yaml:
      - A complete JavaScript implementation
      - https://www.npmjs.com/package/yaml
    import fs from 'fs'
    import YAML from 'yaml'
    
    YAML.parse('3.14159')
    // 3.14159
    
    YAML.parse('[ true, false, maybe, null ]\n')
    // [ true, false, 'maybe', null ]
    
    const file = fs.readFileSync('./file.yml', 'utf8')
    YAML.parse(file)
    // { YAML:
    //   [ 'A human-readable data serialization language',
    //     'https://en.wikipedia.org/wiki/YAML' ],
    //   yaml:
    //   [ 'A complete JavaScript implementation',
    //     'https://www.npmjs.com/package/yaml' ] }

    YAML.stringify

    import YAML from 'yaml'
    
    YAML.stringify(3.14159)
    // '3.14159\n'
    
    YAML.stringify([true, false, 'maybe', null])
    // `- true
    // - false
    // - maybe
    // - null
    // `
    
    YAML.stringify({ number: 3, plain: 'string', block: 'two\nlines\n' })
    // `number: 3
    // plain: string
    // block: >
    //   two
    //
    //   lines
    // `

    Browser testing provided by:

    Install

    npm i yaml

    DownloadsWeekly Downloads

    12,975,459

    Version

    1.10.2

    License

    ISC

    Unpacked Size

    448 kB

    Total Files

    58

    Last publish

    Collaborators

    • avatar