# custom-office-document-properties

> Read document properties from Microsoft Office Open XML documents.

Latest version **1.1.1** (published 2021-02-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install custom-office-document-properties
pnpm add custom-office-document-properties
yarn add custom-office-document-properties
bun add custom-office-document-properties
```

## 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.1.1 |
| Published | 2021-02-05 |
| First published | 2021-02-05 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 164.6 KB |
| Known vulnerabilities | 0 (+1 in 1 direct dependencies) |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Steven Westmoreland |
| Maintainers | inventsable |
| Keywords | parse, document, metadata, properties, microsoft, office, docx, pptx, xlsx, xml |

## Links

- npm: https://www.npmjs.com/package/custom-office-document-properties
- Repository: https://github.com/inventsable/office-document-properties
- Homepage: https://stevenwestmoreland.com/projects/office-document-properties.html
- Issues: https://github.com/inventsable/office-document-properties/issues
- npm.io page: https://npm.io/package/custom-office-document-properties

## Dependencies (3)

- [yauzl](https://npm.io/package/yauzl.md) ^2.10.0
- [lodash](https://npm.io/package/lodash.md) ^4.17.20
- [xml2js](https://npm.io/package/xml2js.md) ^0.4.23

## Alternatives

- [babylon](https://npm.io/package/babylon.md) — 5.1M weekly downloads
- [csscolorparser](https://npm.io/package/csscolorparser.md) — 3.7M weekly downloads
- [expr-eval-fork](https://npm.io/package/expr-eval-fork.md) — 1.5M weekly downloads
- [@leeoniya/ufuzzy](https://npm.io/package/@leeoniya/ufuzzy.md) — 247.7K weekly downloads
- [xml-parser](https://npm.io/package/xml-parser.md) — 78.4K weekly downloads

## Recent versions

- 1.1.1 (latest) — 2021-02-05

## README

## Note: this is a custom fork to address [Issue #6](https://github.com/swestmoreland/office-document-properties/issues/6) of the original package

<h3 align="center">custom-office-document-properties</h3>

<p align="center">Read document properties from Microsoft Office Open XML documents.</p>

<p align="center">
  <a href="https://badge.fury.io/js/custom-office-document-properties">
    <img src="https://badge.fury.io/js/custom-office-document-properties.svg" alt="npm version badge">
  </a>
</p>

## Introduction

Use this node module to read document properties and metadata from Microsoft Office Open XML documents (docx, docm, pptx, pptm, xlsx, xlsm).

## Installation

To install via npm:

```sh
npm install custom-office-document-properties --save
```

## Usage

### Import

```js
var getDocumentProperties = require("custom-office-document-properties");
```

### Read Document Properties from File

```js
getDocumentProperties.fromFilePath(filePath, function (err, data) {
  if (err) throw err;
  console.log(data);
  /*
  {
    application: 'Microsoft Macintosh Word',
    applicationVersion: '15.0000',
    characters: 20,
    comments: 'This is an example document for testing the retrieval of document properties.',
    company: 'Acme',
    created: '2017-09-06T17:32:00Z',
    createdBy: 'Microsoft Office User',
    keywords: 'Example Sample Test Properties',
    manager: 'John Doe',
    modified: '2017-10-13T19:26:00Z',
    modifiedBy: 'Microsoft Office User',
    pages: 1,
    paragraphs: 1,
    revision: 5,
    subject: 'Example',
    template: 'Normal.dotm',
    title: 'Test Word Document',
    totalTime: 8,
    words: 5
  }
  */
});
```

### Read Document Properties from Buffer

```js
getDocumentProperties.fromBuffer(buffer, function (err, data) {
  if (err) throw err;
  console.log(data);
  /*
  {
    application: 'Microsoft Macintosh PowerPoint',
    applicationVersion: '15.0027',
    comments: 'This is an example document for testing the retrieval of document properties.',
    company: 'Acme',
    created: '2017-10-13T15:54:58Z',
    createdBy: 'Microsoft Office User',
    keywords: 'Example Sample Test Properties',
    manager: 'Jane Doe',
    modified: '2017-10-13T19:27:15Z',
    modifiedBy: 'Microsoft Office User',
    notes: 0,
    paragraphs: 2,
    revision: 3,
    slides: 1,
    subject: 'Example',
    title: 'Test PowerPoint Document',
    totalTime: 2,
    words: 8
  }
  */
});
```

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