prettier-plugin-object-multiline weekly downloads statistics

prettier-plugin-object-multiline

A Prettier plugin that enforces one property per line in all object literals, regardless of the printWidth setting.

🚀 Installation

📝 Usage

Once installed, Prettier will automatically use this plugin. No configuration needed!

Example

Input:

Output:

Nested Objects

The plugin also formats nested objects correctly:

Complex Example

The plugin handles complex, deeply nested objects with consistency:

⚙️ How It Works

This plugin overrides the default object expression printer in Prettier to always format objects with one property per line, regardless of the object's length or the printWidth setting.

It uses Prettier's own babel and estree plugins as a foundation and extends them to modify the object expression formatting behavior.

Why Use This Plugin?

• Consistency: Ensures all object properties are formatted in the same way, regardless of object size • Readability: Makes objects easier to read, with each property on its own line • Cleaner Git Diffs: When objects change, Git diffs are cleaner with one property per line • Simplified Editing: Makes it easier to add, remove, or reorder properties • Zero Configuration: Works out of the box with no additional setup

Compatibility

This plugin:

• Requires Prettier v3.0.0 or newer • Is fully compatible with ES Modules • Requires Node.js 18.0.0 or newer • Adds trailing commas to all object properties

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository 2. Create your feature branch (git checkout -b feature/amazing-feature) 3. Commit your changes (git commit -m 'Add some amazing feature') 4. Push to the branch (git push origin feature/amazing-feature) 5. Open a Pull Request

For more detailed information, please see the CONTRIBUTING.md file.

Testing

This plugin uses Node.js built-in test runner. To run the tests:

License

MIT