952 lines
27 KiB
JavaScript
Executable File
952 lines
27 KiB
JavaScript
Executable File
/*
|
|
* EJS Embedded JavaScript templates
|
|
* Copyright 2112 Matthew Eernisse (mde@fleegix.org)
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
/**
|
|
* @file Embedded JavaScript templating engine. {@link http://ejs.co}
|
|
* @author Matthew Eernisse <mde@fleegix.org>
|
|
* @author Tiancheng "Timothy" Gu <timothygu99@gmail.com>
|
|
* @project EJS
|
|
* @license {@link http://www.apache.org/licenses/LICENSE-2.0 Apache License, Version 2.0}
|
|
*/
|
|
|
|
/**
|
|
* EJS internal functions.
|
|
*
|
|
* Technically this "module" lies in the same file as {@link module:ejs}, for
|
|
* the sake of organization all the private functions re grouped into this
|
|
* module.
|
|
*
|
|
* @module ejs-internal
|
|
* @private
|
|
*/
|
|
|
|
/**
|
|
* Embedded JavaScript templating engine.
|
|
*
|
|
* @module ejs
|
|
* @public
|
|
*/
|
|
|
|
|
|
var fs = require('fs');
|
|
var path = require('path');
|
|
var utils = require('./utils');
|
|
|
|
var scopeOptionWarned = false;
|
|
/** @type {string} */
|
|
var _VERSION_STRING = require('../package.json').version;
|
|
var _DEFAULT_OPEN_DELIMITER = '<';
|
|
var _DEFAULT_CLOSE_DELIMITER = '>';
|
|
var _DEFAULT_DELIMITER = '%';
|
|
var _DEFAULT_LOCALS_NAME = 'locals';
|
|
var _NAME = 'ejs';
|
|
var _REGEX_STRING = '(<%%|%%>|<%=|<%-|<%_|<%#|<%|%>|-%>|_%>)';
|
|
var _OPTS_PASSABLE_WITH_DATA = ['delimiter', 'scope', 'context', 'debug', 'compileDebug',
|
|
'client', '_with', 'rmWhitespace', 'strict', 'filename', 'async'];
|
|
// We don't allow 'cache' option to be passed in the data obj for
|
|
// the normal `render` call, but this is where Express 2 & 3 put it
|
|
// so we make an exception for `renderFile`
|
|
var _OPTS_PASSABLE_WITH_DATA_EXPRESS = _OPTS_PASSABLE_WITH_DATA.concat('cache');
|
|
var _BOM = /^\uFEFF/;
|
|
var _JS_IDENTIFIER = /^[a-zA-Z_$][0-9a-zA-Z_$]*$/;
|
|
|
|
/**
|
|
* EJS template function cache. This can be a LRU object from lru-cache NPM
|
|
* module. By default, it is {@link module:utils.cache}, a simple in-process
|
|
* cache that grows continuously.
|
|
*
|
|
* @type {Cache}
|
|
*/
|
|
|
|
exports.cache = utils.cache;
|
|
|
|
/**
|
|
* Custom file loader. Useful for template preprocessing or restricting access
|
|
* to a certain part of the filesystem.
|
|
*
|
|
* @type {fileLoader}
|
|
*/
|
|
|
|
exports.fileLoader = fs.readFileSync;
|
|
|
|
/**
|
|
* Name of the object containing the locals.
|
|
*
|
|
* This variable is overridden by {@link Options}`.localsName` if it is not
|
|
* `undefined`.
|
|
*
|
|
* @type {String}
|
|
* @public
|
|
*/
|
|
|
|
exports.localsName = _DEFAULT_LOCALS_NAME;
|
|
|
|
/**
|
|
* Promise implementation -- defaults to the native implementation if available
|
|
* This is mostly just for testability
|
|
*
|
|
* @type {PromiseConstructorLike}
|
|
* @public
|
|
*/
|
|
|
|
exports.promiseImpl = (new Function('return this;'))().Promise;
|
|
|
|
/**
|
|
* Get the path to the included file from the parent file path and the
|
|
* specified path.
|
|
*
|
|
* @param {String} name specified path
|
|
* @param {String} filename parent file path
|
|
* @param {Boolean} [isDir=false] whether the parent file path is a directory
|
|
* @return {String}
|
|
*/
|
|
exports.resolveInclude = function(name, filename, isDir) {
|
|
var dirname = path.dirname;
|
|
var extname = path.extname;
|
|
var resolve = path.resolve;
|
|
var includePath = resolve(isDir ? filename : dirname(filename), name);
|
|
var ext = extname(name);
|
|
if (!ext) {
|
|
includePath += '.ejs';
|
|
}
|
|
return includePath;
|
|
};
|
|
|
|
/**
|
|
* Try to resolve file path on multiple directories
|
|
*
|
|
* @param {String} name specified path
|
|
* @param {Array<String>} paths list of possible parent directory paths
|
|
* @return {String}
|
|
*/
|
|
function resolvePaths(name, paths) {
|
|
var filePath;
|
|
if (paths.some(function (v) {
|
|
filePath = exports.resolveInclude(name, v, true);
|
|
return fs.existsSync(filePath);
|
|
})) {
|
|
return filePath;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get the path to the included file by Options
|
|
*
|
|
* @param {String} path specified path
|
|
* @param {Options} options compilation options
|
|
* @return {String}
|
|
*/
|
|
function getIncludePath(path, options) {
|
|
var includePath;
|
|
var filePath;
|
|
var views = options.views;
|
|
var match = /^[A-Za-z]+:\\|^\//.exec(path);
|
|
|
|
// Abs path
|
|
if (match && match.length) {
|
|
path = path.replace(/^\/*/, '');
|
|
if (Array.isArray(options.root)) {
|
|
includePath = resolvePaths(path, options.root);
|
|
} else {
|
|
includePath = exports.resolveInclude(path, options.root || '/', true);
|
|
}
|
|
}
|
|
// Relative paths
|
|
else {
|
|
// Look relative to a passed filename first
|
|
if (options.filename) {
|
|
filePath = exports.resolveInclude(path, options.filename);
|
|
if (fs.existsSync(filePath)) {
|
|
includePath = filePath;
|
|
}
|
|
}
|
|
// Then look in any views directories
|
|
if (!includePath && Array.isArray(views)) {
|
|
includePath = resolvePaths(path, views);
|
|
}
|
|
if (!includePath && typeof options.includer !== 'function') {
|
|
throw new Error('Could not find the include file "' +
|
|
options.escapeFunction(path) + '"');
|
|
}
|
|
}
|
|
return includePath;
|
|
}
|
|
|
|
/**
|
|
* Get the template from a string or a file, either compiled on-the-fly or
|
|
* read from cache (if enabled), and cache the template if needed.
|
|
*
|
|
* If `template` is not set, the file specified in `options.filename` will be
|
|
* read.
|
|
*
|
|
* If `options.cache` is true, this function reads the file from
|
|
* `options.filename` so it must be set prior to calling this function.
|
|
*
|
|
* @memberof module:ejs-internal
|
|
* @param {Options} options compilation options
|
|
* @param {String} [template] template source
|
|
* @return {(TemplateFunction|ClientFunction)}
|
|
* Depending on the value of `options.client`, either type might be returned.
|
|
* @static
|
|
*/
|
|
|
|
function handleCache(options, template) {
|
|
var func;
|
|
var filename = options.filename;
|
|
var hasTemplate = arguments.length > 1;
|
|
|
|
if (options.cache) {
|
|
if (!filename) {
|
|
throw new Error('cache option requires a filename');
|
|
}
|
|
func = exports.cache.get(filename);
|
|
if (func) {
|
|
return func;
|
|
}
|
|
if (!hasTemplate) {
|
|
template = fileLoader(filename).toString().replace(_BOM, '');
|
|
}
|
|
}
|
|
else if (!hasTemplate) {
|
|
// istanbul ignore if: should not happen at all
|
|
if (!filename) {
|
|
throw new Error('Internal EJS error: no file name or template '
|
|
+ 'provided');
|
|
}
|
|
template = fileLoader(filename).toString().replace(_BOM, '');
|
|
}
|
|
func = exports.compile(template, options);
|
|
if (options.cache) {
|
|
exports.cache.set(filename, func);
|
|
}
|
|
return func;
|
|
}
|
|
|
|
/**
|
|
* Try calling handleCache with the given options and data and call the
|
|
* callback with the result. If an error occurs, call the callback with
|
|
* the error. Used by renderFile().
|
|
*
|
|
* @memberof module:ejs-internal
|
|
* @param {Options} options compilation options
|
|
* @param {Object} data template data
|
|
* @param {RenderFileCallback} cb callback
|
|
* @static
|
|
*/
|
|
|
|
function tryHandleCache(options, data, cb) {
|
|
var result;
|
|
if (!cb) {
|
|
if (typeof exports.promiseImpl == 'function') {
|
|
return new exports.promiseImpl(function (resolve, reject) {
|
|
try {
|
|
result = handleCache(options)(data);
|
|
resolve(result);
|
|
}
|
|
catch (err) {
|
|
reject(err);
|
|
}
|
|
});
|
|
}
|
|
else {
|
|
throw new Error('Please provide a callback function');
|
|
}
|
|
}
|
|
else {
|
|
try {
|
|
result = handleCache(options)(data);
|
|
}
|
|
catch (err) {
|
|
return cb(err);
|
|
}
|
|
|
|
cb(null, result);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* fileLoader is independent
|
|
*
|
|
* @param {String} filePath ejs file path.
|
|
* @return {String} The contents of the specified file.
|
|
* @static
|
|
*/
|
|
|
|
function fileLoader(filePath){
|
|
return exports.fileLoader(filePath);
|
|
}
|
|
|
|
/**
|
|
* Get the template function.
|
|
*
|
|
* If `options.cache` is `true`, then the template is cached.
|
|
*
|
|
* @memberof module:ejs-internal
|
|
* @param {String} path path for the specified file
|
|
* @param {Options} options compilation options
|
|
* @return {(TemplateFunction|ClientFunction)}
|
|
* Depending on the value of `options.client`, either type might be returned
|
|
* @static
|
|
*/
|
|
|
|
function includeFile(path, options) {
|
|
var opts = utils.shallowCopy(utils.createNullProtoObjWherePossible(), options);
|
|
opts.filename = getIncludePath(path, opts);
|
|
if (typeof options.includer === 'function') {
|
|
var includerResult = options.includer(path, opts.filename);
|
|
if (includerResult) {
|
|
if (includerResult.filename) {
|
|
opts.filename = includerResult.filename;
|
|
}
|
|
if (includerResult.template) {
|
|
return handleCache(opts, includerResult.template);
|
|
}
|
|
}
|
|
}
|
|
return handleCache(opts);
|
|
}
|
|
|
|
/**
|
|
* Re-throw the given `err` in context to the `str` of ejs, `filename`, and
|
|
* `lineno`.
|
|
*
|
|
* @implements {RethrowCallback}
|
|
* @memberof module:ejs-internal
|
|
* @param {Error} err Error object
|
|
* @param {String} str EJS source
|
|
* @param {String} flnm file name of the EJS file
|
|
* @param {Number} lineno line number of the error
|
|
* @param {EscapeCallback} esc
|
|
* @static
|
|
*/
|
|
|
|
function rethrow(err, str, flnm, lineno, esc) {
|
|
var lines = str.split('\n');
|
|
var start = Math.max(lineno - 3, 0);
|
|
var end = Math.min(lines.length, lineno + 3);
|
|
var filename = esc(flnm);
|
|
// Error context
|
|
var context = lines.slice(start, end).map(function (line, i){
|
|
var curr = i + start + 1;
|
|
return (curr == lineno ? ' >> ' : ' ')
|
|
+ curr
|
|
+ '| '
|
|
+ line;
|
|
}).join('\n');
|
|
|
|
// Alter exception message
|
|
err.path = filename;
|
|
err.message = (filename || 'ejs') + ':'
|
|
+ lineno + '\n'
|
|
+ context + '\n\n'
|
|
+ err.message;
|
|
|
|
throw err;
|
|
}
|
|
|
|
function stripSemi(str){
|
|
return str.replace(/;(\s*$)/, '$1');
|
|
}
|
|
|
|
/**
|
|
* Compile the given `str` of ejs into a template function.
|
|
*
|
|
* @param {String} template EJS template
|
|
*
|
|
* @param {Options} [opts] compilation options
|
|
*
|
|
* @return {(TemplateFunction|ClientFunction)}
|
|
* Depending on the value of `opts.client`, either type might be returned.
|
|
* Note that the return type of the function also depends on the value of `opts.async`.
|
|
* @public
|
|
*/
|
|
|
|
exports.compile = function compile(template, opts) {
|
|
var templ;
|
|
|
|
// v1 compat
|
|
// 'scope' is 'context'
|
|
// FIXME: Remove this in a future version
|
|
if (opts && opts.scope) {
|
|
if (!scopeOptionWarned){
|
|
console.warn('`scope` option is deprecated and will be removed in EJS 3');
|
|
scopeOptionWarned = true;
|
|
}
|
|
if (!opts.context) {
|
|
opts.context = opts.scope;
|
|
}
|
|
delete opts.scope;
|
|
}
|
|
templ = new Template(template, opts);
|
|
return templ.compile();
|
|
};
|
|
|
|
/**
|
|
* Render the given `template` of ejs.
|
|
*
|
|
* If you would like to include options but not data, you need to explicitly
|
|
* call this function with `data` being an empty object or `null`.
|
|
*
|
|
* @param {String} template EJS template
|
|
* @param {Object} [data={}] template data
|
|
* @param {Options} [opts={}] compilation and rendering options
|
|
* @return {(String|Promise<String>)}
|
|
* Return value type depends on `opts.async`.
|
|
* @public
|
|
*/
|
|
|
|
exports.render = function (template, d, o) {
|
|
var data = d || utils.createNullProtoObjWherePossible();
|
|
var opts = o || utils.createNullProtoObjWherePossible();
|
|
|
|
// No options object -- if there are optiony names
|
|
// in the data, copy them to options
|
|
if (arguments.length == 2) {
|
|
utils.shallowCopyFromList(opts, data, _OPTS_PASSABLE_WITH_DATA);
|
|
}
|
|
|
|
return handleCache(opts, template)(data);
|
|
};
|
|
|
|
/**
|
|
* Render an EJS file at the given `path` and callback `cb(err, str)`.
|
|
*
|
|
* If you would like to include options but not data, you need to explicitly
|
|
* call this function with `data` being an empty object or `null`.
|
|
*
|
|
* @param {String} path path to the EJS file
|
|
* @param {Object} [data={}] template data
|
|
* @param {Options} [opts={}] compilation and rendering options
|
|
* @param {RenderFileCallback} cb callback
|
|
* @public
|
|
*/
|
|
|
|
exports.renderFile = function () {
|
|
var args = Array.prototype.slice.call(arguments);
|
|
var filename = args.shift();
|
|
var cb;
|
|
var opts = {filename: filename};
|
|
var data;
|
|
var viewOpts;
|
|
|
|
// Do we have a callback?
|
|
if (typeof arguments[arguments.length - 1] == 'function') {
|
|
cb = args.pop();
|
|
}
|
|
// Do we have data/opts?
|
|
if (args.length) {
|
|
// Should always have data obj
|
|
data = args.shift();
|
|
// Normal passed opts (data obj + opts obj)
|
|
if (args.length) {
|
|
// Use shallowCopy so we don't pollute passed in opts obj with new vals
|
|
utils.shallowCopy(opts, args.pop());
|
|
}
|
|
// Special casing for Express (settings + opts-in-data)
|
|
else {
|
|
// Express 3 and 4
|
|
if (data.settings) {
|
|
// Pull a few things from known locations
|
|
if (data.settings.views) {
|
|
opts.views = data.settings.views;
|
|
}
|
|
if (data.settings['view cache']) {
|
|
opts.cache = true;
|
|
}
|
|
// Undocumented after Express 2, but still usable, esp. for
|
|
// items that are unsafe to be passed along with data, like `root`
|
|
viewOpts = data.settings['view options'];
|
|
if (viewOpts) {
|
|
utils.shallowCopy(opts, viewOpts);
|
|
}
|
|
}
|
|
// Express 2 and lower, values set in app.locals, or people who just
|
|
// want to pass options in their data. NOTE: These values will override
|
|
// anything previously set in settings or settings['view options']
|
|
utils.shallowCopyFromList(opts, data, _OPTS_PASSABLE_WITH_DATA_EXPRESS);
|
|
}
|
|
opts.filename = filename;
|
|
}
|
|
else {
|
|
data = utils.createNullProtoObjWherePossible();
|
|
}
|
|
|
|
return tryHandleCache(opts, data, cb);
|
|
};
|
|
|
|
/**
|
|
* Clear intermediate JavaScript cache. Calls {@link Cache#reset}.
|
|
* @public
|
|
*/
|
|
|
|
/**
|
|
* EJS template class
|
|
* @public
|
|
*/
|
|
exports.Template = Template;
|
|
|
|
exports.clearCache = function () {
|
|
exports.cache.reset();
|
|
};
|
|
|
|
function Template(text, opts) {
|
|
opts = opts || utils.createNullProtoObjWherePossible();
|
|
var options = utils.createNullProtoObjWherePossible();
|
|
this.templateText = text;
|
|
/** @type {string | null} */
|
|
this.mode = null;
|
|
this.truncate = false;
|
|
this.currentLine = 1;
|
|
this.source = '';
|
|
options.client = opts.client || false;
|
|
options.escapeFunction = opts.escape || opts.escapeFunction || utils.escapeXML;
|
|
options.compileDebug = opts.compileDebug !== false;
|
|
options.debug = !!opts.debug;
|
|
options.filename = opts.filename;
|
|
options.openDelimiter = opts.openDelimiter || exports.openDelimiter || _DEFAULT_OPEN_DELIMITER;
|
|
options.closeDelimiter = opts.closeDelimiter || exports.closeDelimiter || _DEFAULT_CLOSE_DELIMITER;
|
|
options.delimiter = opts.delimiter || exports.delimiter || _DEFAULT_DELIMITER;
|
|
options.strict = opts.strict || false;
|
|
options.context = opts.context;
|
|
options.cache = opts.cache || false;
|
|
options.rmWhitespace = opts.rmWhitespace;
|
|
options.root = opts.root;
|
|
options.includer = opts.includer;
|
|
options.outputFunctionName = opts.outputFunctionName;
|
|
options.localsName = opts.localsName || exports.localsName || _DEFAULT_LOCALS_NAME;
|
|
options.views = opts.views;
|
|
options.async = opts.async;
|
|
options.destructuredLocals = opts.destructuredLocals;
|
|
options.legacyInclude = typeof opts.legacyInclude != 'undefined' ? !!opts.legacyInclude : true;
|
|
|
|
if (options.strict) {
|
|
options._with = false;
|
|
}
|
|
else {
|
|
options._with = typeof opts._with != 'undefined' ? opts._with : true;
|
|
}
|
|
|
|
this.opts = options;
|
|
|
|
this.regex = this.createRegex();
|
|
}
|
|
|
|
Template.modes = {
|
|
EVAL: 'eval',
|
|
ESCAPED: 'escaped',
|
|
RAW: 'raw',
|
|
COMMENT: 'comment',
|
|
LITERAL: 'literal'
|
|
};
|
|
|
|
Template.prototype = {
|
|
createRegex: function () {
|
|
var str = _REGEX_STRING;
|
|
var delim = utils.escapeRegExpChars(this.opts.delimiter);
|
|
var open = utils.escapeRegExpChars(this.opts.openDelimiter);
|
|
var close = utils.escapeRegExpChars(this.opts.closeDelimiter);
|
|
str = str.replace(/%/g, delim)
|
|
.replace(/</g, open)
|
|
.replace(/>/g, close);
|
|
return new RegExp(str);
|
|
},
|
|
|
|
compile: function () {
|
|
/** @type {string} */
|
|
var src;
|
|
/** @type {ClientFunction} */
|
|
var fn;
|
|
var opts = this.opts;
|
|
var prepended = '';
|
|
var appended = '';
|
|
/** @type {EscapeCallback} */
|
|
var escapeFn = opts.escapeFunction;
|
|
/** @type {FunctionConstructor} */
|
|
var ctor;
|
|
/** @type {string} */
|
|
var sanitizedFilename = opts.filename ? JSON.stringify(opts.filename) : 'undefined';
|
|
|
|
if (!this.source) {
|
|
this.generateSource();
|
|
prepended +=
|
|
' var __output = "";\n' +
|
|
' function __append(s) { if (s !== undefined && s !== null) __output += s }\n';
|
|
if (opts.outputFunctionName) {
|
|
if (!_JS_IDENTIFIER.test(opts.outputFunctionName)) {
|
|
throw new Error('outputFunctionName is not a valid JS identifier.');
|
|
}
|
|
prepended += ' var ' + opts.outputFunctionName + ' = __append;' + '\n';
|
|
}
|
|
if (opts.localsName && !_JS_IDENTIFIER.test(opts.localsName)) {
|
|
throw new Error('localsName is not a valid JS identifier.');
|
|
}
|
|
if (opts.destructuredLocals && opts.destructuredLocals.length) {
|
|
var destructuring = ' var __locals = (' + opts.localsName + ' || {}),\n';
|
|
for (var i = 0; i < opts.destructuredLocals.length; i++) {
|
|
var name = opts.destructuredLocals[i];
|
|
if (!_JS_IDENTIFIER.test(name)) {
|
|
throw new Error('destructuredLocals[' + i + '] is not a valid JS identifier.');
|
|
}
|
|
if (i > 0) {
|
|
destructuring += ',\n ';
|
|
}
|
|
destructuring += name + ' = __locals.' + name;
|
|
}
|
|
prepended += destructuring + ';\n';
|
|
}
|
|
if (opts._with !== false) {
|
|
prepended += ' with (' + opts.localsName + ' || {}) {' + '\n';
|
|
appended += ' }' + '\n';
|
|
}
|
|
appended += ' return __output;' + '\n';
|
|
this.source = prepended + this.source + appended;
|
|
}
|
|
|
|
if (opts.compileDebug) {
|
|
src = 'var __line = 1' + '\n'
|
|
+ ' , __lines = ' + JSON.stringify(this.templateText) + '\n'
|
|
+ ' , __filename = ' + sanitizedFilename + ';' + '\n'
|
|
+ 'try {' + '\n'
|
|
+ this.source
|
|
+ '} catch (e) {' + '\n'
|
|
+ ' rethrow(e, __lines, __filename, __line, escapeFn);' + '\n'
|
|
+ '}' + '\n';
|
|
}
|
|
else {
|
|
src = this.source;
|
|
}
|
|
|
|
if (opts.client) {
|
|
src = 'escapeFn = escapeFn || ' + escapeFn.toString() + ';' + '\n' + src;
|
|
if (opts.compileDebug) {
|
|
src = 'rethrow = rethrow || ' + rethrow.toString() + ';' + '\n' + src;
|
|
}
|
|
}
|
|
|
|
if (opts.strict) {
|
|
src = '"use strict";\n' + src;
|
|
}
|
|
if (opts.debug) {
|
|
console.log(src);
|
|
}
|
|
if (opts.compileDebug && opts.filename) {
|
|
src = src + '\n'
|
|
+ '//# sourceURL=' + sanitizedFilename + '\n';
|
|
}
|
|
|
|
try {
|
|
if (opts.async) {
|
|
// Have to use generated function for this, since in envs without support,
|
|
// it breaks in parsing
|
|
try {
|
|
ctor = (new Function('return (async function(){}).constructor;'))();
|
|
}
|
|
catch(e) {
|
|
if (e instanceof SyntaxError) {
|
|
throw new Error('This environment does not support async/await');
|
|
}
|
|
else {
|
|
throw e;
|
|
}
|
|
}
|
|
}
|
|
else {
|
|
ctor = Function;
|
|
}
|
|
fn = new ctor(opts.localsName + ', escapeFn, include, rethrow', src);
|
|
}
|
|
catch(e) {
|
|
// istanbul ignore else
|
|
if (e instanceof SyntaxError) {
|
|
if (opts.filename) {
|
|
e.message += ' in ' + opts.filename;
|
|
}
|
|
e.message += ' while compiling ejs\n\n';
|
|
e.message += 'If the above error is not helpful, you may want to try EJS-Lint:\n';
|
|
e.message += 'https://github.com/RyanZim/EJS-Lint';
|
|
if (!opts.async) {
|
|
e.message += '\n';
|
|
e.message += 'Or, if you meant to create an async function, pass `async: true` as an option.';
|
|
}
|
|
}
|
|
throw e;
|
|
}
|
|
|
|
// Return a callable function which will execute the function
|
|
// created by the source-code, with the passed data as locals
|
|
// Adds a local `include` function which allows full recursive include
|
|
var returnedFn = opts.client ? fn : function anonymous(data) {
|
|
var include = function (path, includeData) {
|
|
var d = utils.shallowCopy(utils.createNullProtoObjWherePossible(), data);
|
|
if (includeData) {
|
|
d = utils.shallowCopy(d, includeData);
|
|
}
|
|
return includeFile(path, opts)(d);
|
|
};
|
|
return fn.apply(opts.context,
|
|
[data || utils.createNullProtoObjWherePossible(), escapeFn, include, rethrow]);
|
|
};
|
|
if (opts.filename && typeof Object.defineProperty === 'function') {
|
|
var filename = opts.filename;
|
|
var basename = path.basename(filename, path.extname(filename));
|
|
try {
|
|
Object.defineProperty(returnedFn, 'name', {
|
|
value: basename,
|
|
writable: false,
|
|
enumerable: false,
|
|
configurable: true
|
|
});
|
|
} catch (e) {/* ignore */}
|
|
}
|
|
return returnedFn;
|
|
},
|
|
|
|
generateSource: function () {
|
|
var opts = this.opts;
|
|
|
|
if (opts.rmWhitespace) {
|
|
// Have to use two separate replace here as `^` and `$` operators don't
|
|
// work well with `\r` and empty lines don't work well with the `m` flag.
|
|
this.templateText =
|
|
this.templateText.replace(/[\r\n]+/g, '\n').replace(/^\s+|\s+$/gm, '');
|
|
}
|
|
|
|
// Slurp spaces and tabs before <%_ and after _%>
|
|
this.templateText =
|
|
this.templateText.replace(/[ \t]*<%_/gm, '<%_').replace(/_%>[ \t]*/gm, '_%>');
|
|
|
|
var self = this;
|
|
var matches = this.parseTemplateText();
|
|
var d = this.opts.delimiter;
|
|
var o = this.opts.openDelimiter;
|
|
var c = this.opts.closeDelimiter;
|
|
|
|
if (matches && matches.length) {
|
|
matches.forEach(function (line, index) {
|
|
var closing;
|
|
// If this is an opening tag, check for closing tags
|
|
// FIXME: May end up with some false positives here
|
|
// Better to store modes as k/v with openDelimiter + delimiter as key
|
|
// Then this can simply check against the map
|
|
if ( line.indexOf(o + d) === 0 // If it is a tag
|
|
&& line.indexOf(o + d + d) !== 0) { // and is not escaped
|
|
closing = matches[index + 2];
|
|
if (!(closing == d + c || closing == '-' + d + c || closing == '_' + d + c)) {
|
|
throw new Error('Could not find matching close tag for "' + line + '".');
|
|
}
|
|
}
|
|
self.scanLine(line);
|
|
});
|
|
}
|
|
|
|
},
|
|
|
|
parseTemplateText: function () {
|
|
var str = this.templateText;
|
|
var pat = this.regex;
|
|
var result = pat.exec(str);
|
|
var arr = [];
|
|
var firstPos;
|
|
|
|
while (result) {
|
|
firstPos = result.index;
|
|
|
|
if (firstPos !== 0) {
|
|
arr.push(str.substring(0, firstPos));
|
|
str = str.slice(firstPos);
|
|
}
|
|
|
|
arr.push(result[0]);
|
|
str = str.slice(result[0].length);
|
|
result = pat.exec(str);
|
|
}
|
|
|
|
if (str) {
|
|
arr.push(str);
|
|
}
|
|
|
|
return arr;
|
|
},
|
|
|
|
_addOutput: function (line) {
|
|
if (this.truncate) {
|
|
// Only replace single leading linebreak in the line after
|
|
// -%> tag -- this is the single, trailing linebreak
|
|
// after the tag that the truncation mode replaces
|
|
// Handle Win / Unix / old Mac linebreaks -- do the \r\n
|
|
// combo first in the regex-or
|
|
line = line.replace(/^(?:\r\n|\r|\n)/, '');
|
|
this.truncate = false;
|
|
}
|
|
if (!line) {
|
|
return line;
|
|
}
|
|
|
|
// Preserve literal slashes
|
|
line = line.replace(/\\/g, '\\\\');
|
|
|
|
// Convert linebreaks
|
|
line = line.replace(/\n/g, '\\n');
|
|
line = line.replace(/\r/g, '\\r');
|
|
|
|
// Escape double-quotes
|
|
// - this will be the delimiter during execution
|
|
line = line.replace(/"/g, '\\"');
|
|
this.source += ' ; __append("' + line + '")' + '\n';
|
|
},
|
|
|
|
scanLine: function (line) {
|
|
var self = this;
|
|
var d = this.opts.delimiter;
|
|
var o = this.opts.openDelimiter;
|
|
var c = this.opts.closeDelimiter;
|
|
var newLineCount = 0;
|
|
|
|
newLineCount = (line.split('\n').length - 1);
|
|
|
|
switch (line) {
|
|
case o + d:
|
|
case o + d + '_':
|
|
this.mode = Template.modes.EVAL;
|
|
break;
|
|
case o + d + '=':
|
|
this.mode = Template.modes.ESCAPED;
|
|
break;
|
|
case o + d + '-':
|
|
this.mode = Template.modes.RAW;
|
|
break;
|
|
case o + d + '#':
|
|
this.mode = Template.modes.COMMENT;
|
|
break;
|
|
case o + d + d:
|
|
this.mode = Template.modes.LITERAL;
|
|
this.source += ' ; __append("' + line.replace(o + d + d, o + d) + '")' + '\n';
|
|
break;
|
|
case d + d + c:
|
|
this.mode = Template.modes.LITERAL;
|
|
this.source += ' ; __append("' + line.replace(d + d + c, d + c) + '")' + '\n';
|
|
break;
|
|
case d + c:
|
|
case '-' + d + c:
|
|
case '_' + d + c:
|
|
if (this.mode == Template.modes.LITERAL) {
|
|
this._addOutput(line);
|
|
}
|
|
|
|
this.mode = null;
|
|
this.truncate = line.indexOf('-') === 0 || line.indexOf('_') === 0;
|
|
break;
|
|
default:
|
|
// In script mode, depends on type of tag
|
|
if (this.mode) {
|
|
// If '//' is found without a line break, add a line break.
|
|
switch (this.mode) {
|
|
case Template.modes.EVAL:
|
|
case Template.modes.ESCAPED:
|
|
case Template.modes.RAW:
|
|
if (line.lastIndexOf('//') > line.lastIndexOf('\n')) {
|
|
line += '\n';
|
|
}
|
|
}
|
|
switch (this.mode) {
|
|
// Just executing code
|
|
case Template.modes.EVAL:
|
|
this.source += ' ; ' + line + '\n';
|
|
break;
|
|
// Exec, esc, and output
|
|
case Template.modes.ESCAPED:
|
|
this.source += ' ; __append(escapeFn(' + stripSemi(line) + '))' + '\n';
|
|
break;
|
|
// Exec and output
|
|
case Template.modes.RAW:
|
|
this.source += ' ; __append(' + stripSemi(line) + ')' + '\n';
|
|
break;
|
|
case Template.modes.COMMENT:
|
|
// Do nothing
|
|
break;
|
|
// Literal <%% mode, append as raw output
|
|
case Template.modes.LITERAL:
|
|
this._addOutput(line);
|
|
break;
|
|
}
|
|
}
|
|
// In string mode, just add the output
|
|
else {
|
|
this._addOutput(line);
|
|
}
|
|
}
|
|
|
|
if (self.opts.compileDebug && newLineCount) {
|
|
this.currentLine += newLineCount;
|
|
this.source += ' ; __line = ' + this.currentLine + '\n';
|
|
}
|
|
}
|
|
};
|
|
|
|
/**
|
|
* Escape characters reserved in XML.
|
|
*
|
|
* This is simply an export of {@link module:utils.escapeXML}.
|
|
*
|
|
* If `markup` is `undefined` or `null`, the empty string is returned.
|
|
*
|
|
* @param {String} markup Input string
|
|
* @return {String} Escaped string
|
|
* @public
|
|
* @func
|
|
* */
|
|
exports.escapeXML = utils.escapeXML;
|
|
|
|
/**
|
|
* Express.js support.
|
|
*
|
|
* This is an alias for {@link module:ejs.renderFile}, in order to support
|
|
* Express.js out-of-the-box.
|
|
*
|
|
* @func
|
|
*/
|
|
|
|
exports.__express = exports.renderFile;
|
|
|
|
/**
|
|
* Version of EJS.
|
|
*
|
|
* @readonly
|
|
* @type {String}
|
|
* @public
|
|
*/
|
|
|
|
exports.VERSION = _VERSION_STRING;
|
|
|
|
/**
|
|
* Name for detection of EJS.
|
|
*
|
|
* @readonly
|
|
* @type {String}
|
|
* @public
|
|
*/
|
|
|
|
exports.name = _NAME;
|
|
|
|
/* istanbul ignore if */
|
|
if (typeof window != 'undefined') {
|
|
window.ejs = exports;
|
|
}
|