# touch

> like touch(1) in node

Latest version **3.1.1** (published 2024-05-14) · ISC license · 0 weekly downloads

## Install

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

Provides the command `nodetouch`.

## Health

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

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 3.1.1 |
| Published | 2024-05-14 |
| First published | 2011-10-05 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | separate (@types/touch) |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 9.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 125 |
| Author | Isaac Z. Schlueter |
| Maintainers | isaacs |

## Links

- npm: https://www.npmjs.com/package/touch
- Repository: https://github.com/isaacs/node-touch
- Homepage: https://github.com/isaacs/node-touch#readme
- Issues: https://github.com/isaacs/node-touch/issues
- npm.io page: https://npm.io/package/touch

## Recent versions

- 3.1.1 (latest) — 2024-05-14
- 3.1.0 — 2017-06-30
- 3.0.0 — 2017-06-30
- 2.0.2 — 2017-06-27
- 2.0.1 — 2017-06-27
- 2.0.0 — 2017-06-27
- 1.0.0 — 2015-07-17
- 0.0.4 — 2015-07-15
- 0.0.3 — 2014-01-25
- 0.0.2 — 2012-07-12
- 0.0.1 — 2011-10-05

## README

# node-touch

For all your node touching needs.

## Installing

```bash
npm install touch
```

## CLI Usage:

See `man touch`

This package exports a binary called `nodetouch` that works mostly
like the unix builtin `touch(1)`.

## API Usage:

```javascript
var touch = require("touch")
```

Gives you the following functions:

* `touch(filename, options, cb)`
* `touch.sync(filename, options)`
* `touch.ftouch(fd, options, cb)`
* `touch.ftouchSync(fd, options)`

All the `options` objects are optional.

All the async functions return a Promise.  If a callback function is
provided, then it's attached to the Promise.

## Options

* `force` like `touch -f` Boolean
* `time` like `touch -t <date>` Can be a Date object, or any parseable
  Date string, or epoch ms number.
* `atime` like `touch -a` Can be either a Boolean, or a Date.
* `mtime` like `touch -m` Can be either a Boolean, or a Date.
* `ref` like `touch -r <file>` Must be path to a file.
* `nocreate` like `touch -c` Boolean

If neither `atime` nor `mtime` are set, then both values are set.  If
one of them is set, then the other is not.

## cli

This package creates a `nodetouch` command line executable that works
very much like the unix builtin `touch(1)`

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