Product
Introducing SSO
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
outdent
Advanced tools
Readme
ES6 template strings are great, but they preserve everything between the backticks, including leading spaces. Sometimes I want to indent my template literals to make my code more readable without including all those spaces in the string.
Outdent will remove those leading spaces, as well as the leading and trailing newlines.
Import outdent using your module system of choice.
// Deno
import outdent from 'http://deno.land/x/outdent/mod.ts';
// ECMAScript modules
import outdent from 'outdent';
// CommonJS
const outdent = require('outdent');
import outdent from 'outdent';
const markdown = outdent`
# My Markdown File
Here is some indented code:
console.log("hello world!");
`;
console.log(markdown);
fs.writeFileSync('output.md', markdown);
The contents of output.md
do not have the leading indentation:
# My Markdown File
Here is some indented code:
console.log("hello world!");
As a JavaScript string:
var markdown = '# My Markdown File\n' +
'\n' +
'Here is some indented code:\n' +
'\n' +
' console.log("hello world!");';
You can pass options to outdent to control its behavior. They are explained in Options.
const output = outdent({trimLeadingNewline: false, trimTrailingNewline: false})`
Hello world!
`;
assert(output === '\nHello world!\n');
You can explicitly specify the indentation level by passing outdent
as the first interpolated value. Its position sets the indentation level and it is removed from the output:
const output = outdent`
${outdent}
Yo
12345
Hello world
`;
assert(output === ' Yo\n345\n Hello world');
Note: ${outdent}
must be alone on its own line without anything before or after it. It cannot be preceded by any non-whitespace characters.
If these conditions are not met, outdent will follow normal indentation-detection behavior.
Outdent can also remove indentation from plain strings via the string
method.
const output = outdent.string('\n Hello world!\n');
assert(output === 'Hello world!');
trimLeadingNewline
Default: true
trimTrailingNewline
Default: true
Whether or not outdent should remove the leading and/or trailing newline from your template string. For example:
var s = outdent({trimLeadingNewline: false})`
Hello
`;
assert(s === '\nHello');
s = outdent({trimTrailingNewline: false})`
Hello
`
assert(s === 'Hello\n');
s = outdent({trimLeadingNewline: false, trimTrailingNewline: false})`
`;
assert(s === '\n\n');
newline
Default: null
If set to a string, normalize all newlines in the template literal to this value.
If null
, newlines are left untouched.
s = outdent({newline: '\r\n'}) `
first
second
`;
assert(s === 'first\r\nsecond');
Newlines that get normalized are '\r\n', '\r', and '\n'.
Newlines within interpolated values are never normalized.
Although intended for normalizing to '\r\n', you can use any string, for example a space.
const s = outdent({newline: ' '}) `
Hello
world!
`;
assert(s === 'Hello world!');
Start the contents of your template string on a new line after the opening backtick. Otherwise, outdent has no choice but to detect indentation from the second line, which does not work in all situations.
// Bad
const output = outdent `* item 1
* sub-item
`;
// output === '* item 1\n* sub-item'; Indentation of sub-item is lost
// Good
const output = outdent `
* item 1
* sub-item
`;
Spaces and tabs are treated identically. outdent does not verify that you are using spaces or tabs consistently; they are all treated as a single character for the purpose of removing indentation. Spaces, tabs, and smart tabs should all work correctly provided you use them consistently.
This module includes TypeScript type declarations so you will get code completion and error-checking without installing anything else.
File an issue on Github: https://github.com/cspotcode/outdent/issues
FAQs
Remove leading indentation from ES6 template literals.
The npm package outdent receives a total of 1,103,369 weekly downloads. As such, outdent popularity was classified as popular.
We found that outdent demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Streamline your login process and enhance security by enabling Single Sign-On (SSO) on the Socket platform, now available for all customers on the Enterprise plan, supporting 20+ identity providers.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.