# v-safe

> Vue.js directive to show text values from deep objects without any errors

Latest version **0.2.0** (published 2019-04-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install v-safe
pnpm add v-safe
yarn add v-safe
bun add v-safe
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.0 |
| Published | 2019-04-24 |
| First published | 2019-04-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 5.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Igor Guastalla de Lima |
| Maintainers | guastallaigor |
| Keywords | vue.js, vue, vue-safe, v-safe |

## Links

- npm: https://www.npmjs.com/package/v-safe
- Repository: https://github.com/guastallaigor/v-safe
- Homepage: https://github.com/guastallaigor/v-safe#readme
- Issues: https://github.com/guastallaigor/v-safe/issues
- npm.io page: https://npm.io/package/v-safe

## Recent versions

- 0.2.0 (latest) — 2019-04-24
- 0.1.0 — 2019-04-24

## README

<div align="center">
  <h1>v-safe</h1>
</div>
<p align="center">
  Vue.js directive to show text values from deep objects without any errors
</p>

[![Version](https://img.shields.io/npm/v/v-safe.svg)](https://github.com/guastallaigor/v-safe/)
[![Github file size](https://img.shields.io/github/size/guastallaigor/v-safe/dist/v-safe.min.js.svg)](https://raw.githubusercontent.com/guastallaigor/v-safe/master/dist/v-safe.min.js)
[![Downloads](https://img.shields.io/npm/dt/v-safe.svg)](https://github.com/guastallaigor/v-safe/)
[![Vue2](https://img.shields.io/badge/Vue-2.x-brightgreen.svg)](https://vuejs.org/)
[![Say Thanks!](https://img.shields.io/badge/Say%20Thanks-!-1EAEDB.svg)](https://saythanks.io/to/guastallaigor)

## Why

This is meant to avoid this type of error when you are using deep objects, that usually can happen when you're expecting a deep object after a Promise

```html
<span>{{ a.b.c.d }}</span>
```

> [Vue warn]: Error in render: "TypeError: Cannot read property 'c' of undefined"

## How to install

### npm

```bash
$ npm install v-safe --save
```

### yarn

```bash
$ yarn add v-safe
```

## Quick start
### Vue.js

You can import in you `main.js` file

```js
import Vue from 'vue'
import VSafe from 'v-safe'

Vue.use(VSafe)
```

### Nuxt.js

You can import as a Nuxt.js plugin

`~/plugins/v-safe.js`
```js
import Vue from 'vue'
import VSafe from 'v-safe'

Vue.use(VSafe)
```

and then import it in your `nuxt.config.js` file
```js
plugins: [
  '~/plugins/v-safe.js'
]
```

## Basic usage

```html
<template>
  <span v-safe="'a.b.c.d'"></span>
</template>

<script>
export default {
  data:() => ({
    a: {
      b: {
        c: {
          d: 'safe'
        }
      }
    }
  })
}
</script>
```

## Development

[![contributions welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat)](https://github.com/guastallaigor/v-safe/issues)

Fork the project and enter this commands in your terminal

```sh
git clone https://github.com/YOUR_GITHUB_USERNAME/v-safe.git
cd v-safe
yarn
```

## License

MIT © [guastallaigor](https://github.com/guastallaigor/v-safe/blob/master/LICENSE)

---
_Source: https://npm.io/package/v-safe · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._