# andlog

> Super-simple, client-side CommonJS logging thingy

Latest version **1.0.2** (published 2019-11-01) · 0 weekly downloads

## Install

```sh
npm install andlog
pnpm add andlog
yarn add andlog
bun add andlog
```

## Health

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

Positive: no vulnerabilities.

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

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.2 |
| Published | 2019-11-01 |
| First published | 2012-08-15 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 3.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 97 |
| Author | Henrik Joreteg |
| Maintainers | henrikjoreteg |

## Links

- npm: https://www.npmjs.com/package/andlog
- Repository: https://github.com/HenrikJoreteg/andlog
- Homepage: https://github.com/HenrikJoreteg/andlog#readme
- Issues: https://github.com/HenrikJoreteg/andlog/issues
- npm.io page: https://npm.io/package/andlog

## Recent versions

- 1.0.2 (latest) — 2019-11-01
- 1.0.1 — 2018-01-26
- 1.0.0 — 2014-06-18
- 0.0.4 — 2013-06-27
- 0.0.3 — 2012-08-15
- 0.0.2 — 2012-08-15

## README

# &log

Super simple, but solves these pain points:

- Lets you leave log statements in production, client-side code.
- It won't log anything unless `localStorage.debug` is set.
- Uses native `console` rather than trying to wrap it in something (which makes the output ugly).
- Works with CommonJS.
- It's just a selective alias for the `window.console` so the normal API applies.

## How to use it:


Step 1. include it:

```html
<script src="andlog.js"></script>
```

Step 2. Use the `console` in your code as usual:

```javascript
console.log("hello");
```

Step 3. If you want to see log output set a value called `debug` in `localStorage` by doing typing this in console:

```javascript
localStorage.debug = true
```

  If you'd like to use a custom debug key then set `localStorage.andlogKey = 'something-else'` and then set `localStorage['something-else'] = true` to enable logging.

Step 4. Refresh the page, you should now see logs.

Step 5. To turn off console, just delete the localStorage flag:

```javascript
delete localStorage.debug
```

Step 6. Feel free to deploy to production with console stuff in there.


## CommonJS Version

If you're using this on the client but your project is in node.js you can install this with: [browserify](https://github.com/substack/node-browserify/) and npm.

```javascript
var logger = require('andlog');

logger.log('hello');
```

This is identical to:

```javascript
console.log('hello');
```

You *could* even get fancy and call it `console`. However by doing this you take the risk that you'll forget to `require` it and it'll still work and you'll ship it to production. However, obviously this would work as well:

```javascript
var console = require('andlog');

console.log('hello');
```

## Releases

- `1.0.2` bug fix to make sure `ls` is always defined.

## License

MIT

If you like this, follow [@HenrikJoreteg](http://twitter.com/henrikjoreteg) on the twitterwebz.

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