README
fake-tag
A fake template literal tag to trick syntax highlighters, linters and formatters into action. Interpolations and escapes are tested.
Installation
To install with npm, run:
npm install fake-tag
Examples
Tagging a GraphQL SDL string with gql
:
import gql from "fake-tag";
const typeDefs = gql`
"A foo."
type Foo {
"The \`Foo\` ID."
id: ID!
}
`;
Exports
These ECMAScript modules are published to npm and exported via the package.json
exports
field:
FAQ
Why not comment tags?
A comment tag looks like this:
const QUERY = /* GraphQL */ `
{
foo
}
`;
They are far superior to a fake tag:
- No dependency to manage.
- No inconvenient imports.
- No bundle size bloat.
- No runtime overhead.
Unfortunately not all tools support them yet. prettier
has since v1.13.0, but eslint-plugin-graphql
at v3.1.0 still doesn’t.
String.raw
?
Why not This may be temptingly simple:
const gql = String.raw;
const QUERY = gql`
{
foo
}
`;
However, it doesn’t unescape characters. For the usage example, if you console.log(typeDefs)
before and after replacing the import with const gql = String.raw
you will see the difference in the type description markdown:
"A foo."
type Foo {
- "The `Foo` ID."
+ "The \`Foo\` ID."
id: ID!
}