# \<polymer-cookie\>

> Cookie Web Component for Polymer 1.x

[![npm](https://img.shields.io/npm/v/polymer-cookie.svg?maxAge=86400)]()
[![Bower](https://img.shields.io/bower/v/polymer-cookie.svg?maxAge=86400)]()
[![Build Status](https://travis-ci.org/andreasonny83/generator-polymer.svg?branch=master)](https://travis-ci.org/andreasonny83/generator-polymer)

![](http://benschwarz.github.io/bower-badges/badge@2x.png)

Cookie Web Component for Polymer 1.x

```html
<polymer-cookie
  id="test_cookie"
  name="test_cookie"
  value="hello world"
  time="2"
  format="h">
</polymer-cookie>

<polymer-cookie
  id="test_cookie2"
  name="test_cookie2"
  value="hello world!"
  auto-set>
</polymer-cookie>
```

Note: The `params` attribute must be double quoted JSON.

## Usage

Add the library using the Javascript package manager [Bower](http://bower.io/):

```shell
$ bower install --save polymer-cookie
```

Or clone this repository inside your project folder using Git:

```shell
$ git clone https://github.com/andreasonny83/polymer-cookie.git
```

## Properties

### name

Type: String

Default value: 'polymer-cookie'

Set the cookie name

### value

type: String

Default value: ''

The cookie value

### path

type: String

Default value: ''

The cookie path.

The path must be absolute.
If not specified, defaults to the current path of the current document location.

### domain

type: String

Default value: ''

The cookie domain.

(e.g., 'example.com' or 'subdomain.example.com').
If not specified, defaults to the host portion of the current document location
(but not including subdomains). Contrary to earlier specifications,
leading dots in domain names are ignored. If a domain is specified,
subdomains are always included.

### time

type: Number

Default value: 1

The expiration time related to the 'format' value.
Set to -1 to never expire the cookie

### format

type: String

Default value: 'd'

The expiration format time

*   's' : seconds
*   'm' : minutes
*   'h' : hours
*   'd' : days

### secure

type: Boolean

Default value: false

Cookie to only be transmitted over secure protocol as https

### http-only

type: Boolean

Default value: false

The HTTPOnly cookie attribute can help to mitigate this attack by
preventing access to cookie value through Javascript. Read more about
[Cookies and Security](https://www.nczonline.net/blog/2009/05/12/cookies-and-security/).

### auto-set

type: Boolean

Default value: false

If set, creates the cookie as the element is rendered on the page without
the need of manually invoking createCookie

## Methods

### createCookie

Write the cookie

```js
var cookie = Polymer.dom(document).querySelector('#user_cookie');
cookie.createCookie();
```

### readCookie

Read the cookie if any, and the returns its value

```js
var cookie = Polymer.dom(document).querySelector('#user_cookie');
var cookie_value = cookie.readCookie();
```

### eraseCookie

Destroy the cookie

```js
var cookie = Polymer.dom(document).querySelector('#user_cookie');
cookie.eraseCookie();
```

## Rendering in a demo page

### Install Polymer CLI

Install the Polymer CLI to serve the demo locally with:

```shell
$ npm install -g polymer-cli
```

### Run the demo

First install all the project dependencies with:

```shell
$ bower install
```

Then, run Polymer serve from the repo directory with:

```shell
$ polymer serve
```

Then open localhost:8080/components/polymer-cookie/demo/ in your browser.

For more information about Polymer CLI have a look at the
[official documentation](https://www.polymer-project.org/1.0/start/first-element/intro)

## Contributing

1.  Fork it!
2.  Create your feature branch: `git checkout -b my-new-feature`
3.  Commit your changes: `git commit -m 'Add some feature'`
4.  Push to the branch: `git push origin my-new-feature`
5.  Submit a pull request :D

## Contributors

A special thanks to our contributors:

*   [@cameronwp](https://github.com/cameronwp)
*   [@MeTaNoV](https://github.com/MeTaNoV)
*   [@ymahnovskyy](https://github.com/ymahnovskyy)
*   [@web-padawan](https://github.com/web-padawan)

## Changelog

Changelog available [here](https://github.com/andreasonny83/polymer-cookie/blob/master/CHANGELOG.md)

## License

[MIT License](https://github.com/andreasonny83/polymer-cookie/blob/master/LICENSE)
© Andrea SonnY