import { RenderError } from '../../../src/util/error' import { Liquid } from '../../../src/liquid' import * as path from 'path' import { mock, restore } from '../../stub/mockfs' let engine = new Liquid() const strictEngine = new Liquid({ strictVariables: true, strictFilters: true }) describe('error', function () { afterEach(restore) describe('TokenizationError', function () { it('should throw TokenizationError when tag illegal', async function () { await expect(engine.parseAndRender('{% . a %}', {})).rejects.toMatchObject({ name: 'TokenizationError', message: expect.stringContaining('illegal tag syntax') }) }) it('should contain template content in err.message', async function () { const html = ['1st', '2nd', 'X{% . a %} Y', '4th'] const message = [ ' 1| 1st', ' 2| 2nd', '>> 3| X{% . a %} Y', ' ^', ' 4| 4th', 'TokenizationError' ] await expect(engine.parseAndRender(html.join('\n'))).rejects.toMatchObject({ message: 'illegal tag syntax, tag name expected, line:3, col:5', stack: expect.stringContaining(message.join('\n')), name: 'TokenizationError' }) }) it('should contain the whole template content in err.token.input', async function () { const html = 'bar\nfoo{% . a %}\nfoo' await expect(engine.parseAndRender(html)).rejects.toMatchObject({ token: expect.objectContaining({ input: html }) }) }) it('should contain stack in err.stack', async function () { await expect(engine.parseAndRender('{% . a %}')).rejects.toMatchObject({ message: expect.stringContaining('illegal tag syntax'), stack: expect.stringContaining('at Liquid.parse') }) }) describe('captureStackTrace compatibility', function () { it('should be empty when captureStackTrace undefined', async function () { await expect(engine.parseAndRender('{% . a %}')).rejects.toMatchObject({ stack: expect.stringContaining('illegal tag syntax') }) await expect(engine.parseAndRender('{% . a %}')).rejects.toMatchObject({ stack: expect.not.stringContaining('at Object.parse') }) }) }) it('should throw error with [line, col] if tag unmatched', async function () { await expect(engine.parseAndRender('1\n2\nfoo{% assign a = 4 }\n4')).rejects.toMatchObject({ name: 'TokenizationError', message: 'tag "{% assign a = 4 }\\n4" not closed, line:3, col:4' }) }) }) describe('RenderError', function () { beforeEach(function () { engine = new Liquid({ root: '/' }) engine.registerTag('throwingTag', { render: function () { throw new Error('intended render error') } }) engine.registerTag('rejectingTag', { render: async function () { throw new Error('intended render reject') } }) engine.registerFilter('throwingFilter', () => { throw new Error('throwed by filter') }) }) it('should throw RenderError when tag throws', async function () { const src = '{%throwingTag%}' await expect(engine.parseAndRender(src)).rejects.toMatchObject({ name: 'RenderError', message: expect.stringContaining('intended render error') }) }) it('should throw RenderError when tag rejects', async function () { const src = '{%rejectingTag%}' await expect(engine.parseAndRender(src)).rejects.toMatchObject({ name: 'RenderError', message: expect.stringContaining('intended render reject') }) }) it('should throw RenderError when filter throws', async function () { const src = '{{1|throwingFilter}}' await expect(engine.parseAndRender(src)).rejects.toMatchObject({ name: 'RenderError', message: expect.stringContaining('throwed by filter') }) }) it('should not throw when variable undefined by default', async function () { const html = await engine.parseAndRender('X{{a}}Y') return expect(html).toBe('XY') }) it('should throw RenderError when variable not defined', async function () { await expect(strictEngine.parseAndRender('{{a}}')).rejects.toMatchObject({ name: 'RenderError', message: expect.stringContaining('undefined variable: a') }) }) it('should contain template context in err.stack', async function () { const html = ['1st', '2nd', '3rd', 'X{%throwingTag%} Y', '5th', '6th', '7th'] const message = [ ' 2| 2nd', ' 3| 3rd', '>> 4| X{%throwingTag%} Y', ' ^', ' 5| 5th', ' 6| 6th', ' 7| 7th', 'RenderError' ] await expect(engine.parseAndRender(html.join('\n'))).rejects.toMatchObject({ name: 'RenderError', message: 'intended render error, line:4, col:2', stack: expect.stringContaining(message.join('\n')) }) }) it('should contain original error info for {% layout %}', async function () { mock({ '/throwing-tag.html': [ '1st', '2nd', '3rd', 'X{%throwingTag%} Y', '5th', '{%block%}{%endblock%}', '7th' ].join('\n') }) const html = '{%layout "throwing-tag.html"%}' const message = [ ' 2| 2nd', ' 3| 3rd', '>> 4| X{%throwingTag%} Y', ' ^', ' 5| 5th', ' 6| {%block%}{%endblock%}', ' 7| 7th', 'RenderError' ] await expect(engine.parseAndRender(html)).rejects.toMatchObject({ name: 'RenderError', message: `intended render error, file:${path.resolve('/throwing-tag.html')}, line:4, col:2`, stack: expect.stringContaining(message.join('\n')) }) }) it('should contain original error info for {% include %}', async function () { const origin = ['1st', '2nd', '3rd', 'X{%throwingTag%} Y', '5th', '6th', '7th'] mock({ '/throwing-tag.html': origin.join('\n') }) const html = '{%include "throwing-tag.html"%}' const message = [ ' 2| 2nd', ' 3| 3rd', '>> 4| X{%throwingTag%} Y', ' ^', ' 5| 5th', ' 6| 6th', ' 7| 7th', 'RenderError' ] await expect(engine.parseAndRender(html)).rejects.toMatchObject({ name: 'RenderError', message: `intended render error, file:${path.resolve('/throwing-tag.html')}, line:4, col:2`, stack: expect.stringContaining(message.join('\n')) }) }) it('should contain stack in err.stack', async function () { await expect(engine.parseAndRender('{%rejectingTag%}')).rejects.toMatchObject({ message: expect.stringContaining('intended render reject'), stack: expect.stringMatching(/at .*:\d+:\d+/) }) }) }) describe('ParseError', function () { beforeEach(function () { engine = new Liquid() engine.registerTag('throwsOnParse', { parse: function () { throw new Error('intended parse error') }, render: () => '' }) }) it('should throw ParseError when filter not defined', async function () { await expect(strictEngine.parseAndRender('{{1 | a}}')).rejects.toMatchObject({ name: 'ParseError', message: expect.stringContaining('undefined filter: a') }) }) it('should throw ParseError when tag not closed', async function () { await expect(engine.parseAndRender('{% if true %}')).rejects.toMatchObject({ name: 'ParseError', message: expect.stringContaining('tag {% if true %} not closed') }) }) it('should throw ParseError when tag value not specified', async function () { await expect(engine.parseAndRender('{% if %}{% endif %}')).rejects.toMatchObject({ name: 'TokenizationError', message: 'invalid value expression: "", line:1, col:1' }) }) it('should throw ParseError when tag parse throws', async function () { await expect(engine.parseAndRender('{%throwsOnParse%}')).rejects.toMatchObject({ name: 'ParseError', message: expect.stringContaining('intended parse error') }) }) it('should throw ParseError when tag not found', async function () { const src = '{%if true%}\naaa{%endif%}\n{% -a %}\n3' await expect(engine.parseAndRender(src)).rejects.toMatchObject({ name: 'ParseError', message: expect.stringContaining('tag "-a" not found') }) }) it('should throw ParseError when tag not exist', async function () { await expect(engine.parseAndRender('{% a %}')).rejects.toMatchObject({ name: 'ParseError', message: expect.stringContaining('tag "a" not found') }) }) it('should contain template context in err.stack', async function () { const html = ['1st', '2nd', '3rd', 'X{% a %} {% enda %} Y', '5th', '6th', '7th'] const message = [ ' 2| 2nd', ' 3| 3rd', '>> 4| X{% a %} {% enda %} Y', ' ^', ' 5| 5th', ' 6| 6th', ' 7| 7th', 'ParseError: tag "a" not found' ] await expect(engine.parseAndRender(html.join('\n'))).rejects.toMatchObject({ name: 'ParseError', message: 'tag "a" not found, line:4, col:2', stack: expect.stringContaining(message.join('\n')) }) }) it('should handle err.message when context not enough', async function () { const html = ['1st', 'X{% a %} {% enda %} Y', '3rd', '4th'] const message = [ ' 1| 1st', '>> 2| X{% a %} {% enda %} Y', ' ^', ' 3| 3rd', ' 4| 4th', 'ParseError: tag "a" not found' ] await expect(engine.parseAndRender(html.join('\n'))).rejects.toMatchObject({ message: 'tag "a" not found, line:2, col:2', stack: expect.stringContaining(message.join('\n')) }) }) it('should contain stack in err.stack', async function () { await expect(engine.parseAndRender('{% -a %}')).rejects.toMatchObject({ stack: expect.stringContaining('ParseError: tag "-a" not found') }) await expect(engine.parseAndRender('{% -a %}')).rejects.toMatchObject({ stack: expect.stringMatching(/at .*:\d+:\d+\)/) }) }) }) describe('sync support', function () { let engine: Liquid beforeEach(function () { engine = new Liquid({ root: '/' }) engine.registerTag('throwingTag', { render: function () { throw new Error('intended render error') } }) }) it('should throw RenderError when tag throws', function () { const src = '{%throwingTag%}' expect(() => engine.parseAndRenderSync(src)).toThrow(RenderError) expect(() => engine.parseAndRenderSync(src)).toThrow(/intended render error/) }) it('should contain original error info for {% include %}', function () { mock({ '/throwing-tag.html': ['1st', '2nd', '3rd', 'X{%throwingTag%} Y', '5th', '6th', '7th'].join('\n') }) const html = '{%include "throwing-tag.html"%}' const message = [ ' 2| 2nd', ' 3| 3rd', '>> 4| X{%throwingTag%} Y', ' ^', ' 5| 5th', ' 6| 6th', ' 7| 7th', 'RenderError' ] try { engine.parseAndRenderSync(html) throw new Error('expected throw') } catch (err) { expect(err).toHaveProperty('name', 'RenderError') expect(err).toHaveProperty('message', `intended render error, file:${path.resolve('/throwing-tag.html')}, line:4, col:2`) expect(err).toHaveProperty('stack', expect.stringContaining(message.join('\n'))) } }) }) })