| /* |
| * 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; |
| var _VERSION_STRING = require('../package.json').version; |
| 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/; |
| |
| /** |
| * 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 {Function} |
| * @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 parent file path whether is 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; |
| }; |
| |
| /** |
| * 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; |
| |
| // Abs path |
| if (path.charAt(0) == '/') { |
| includePath = exports.resolveInclude(path.replace(/^\/*/,''), 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) { |
| if (Array.isArray(views) && views.some(function (v) { |
| filePath = exports.resolveInclude(path, v, true); |
| return fs.existsSync(filePath); |
| })) { |
| includePath = filePath; |
| } |
| } |
| if (!includePath) { |
| 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({}, options); |
| opts.filename = getIncludePath(path, opts); |
| return handleCache(opts); |
| } |
| |
| /** |
| * Get the JavaScript source of an included file. |
| * |
| * @memberof module:ejs-internal |
| * @param {String} path path for the specified file |
| * @param {Options} options compilation options |
| * @return {Object} |
| * @static |
| */ |
| |
| function includeSource(path, options) { |
| var opts = utils.shallowCopy({}, options); |
| var includePath; |
| var template; |
| includePath = getIncludePath(path, opts); |
| template = fileLoader(includePath).toString().replace(_BOM, ''); |
| opts.filename = includePath; |
| var templ = new Template(template, opts); |
| templ.generateSource(); |
| return { |
| source: templ.source, |
| filename: includePath, |
| template: template |
| }; |
| } |
| |
| /** |
| * 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} filename file name of the EJS file |
| * @param {String} lineno line number of the error |
| * @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); // eslint-disable-line |
| // 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 || {}; |
| var opts = o || {}; |
| |
| // 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 = {}; |
| } |
| |
| return tryHandleCache(opts, data, cb); |
| }; |
| |
| /** |
| * Clear intermediate JavaScript cache. Calls {@link Cache#reset}. |
| * @public |
| */ |
| |
| exports.clearCache = function () { |
| exports.cache.reset(); |
| }; |
| |
| function Template(text, opts) { |
| opts = opts || {}; |
| var options = {}; |
| this.templateText = text; |
| this.mode = null; |
| this.truncate = false; |
| this.currentLine = 1; |
| this.source = ''; |
| this.dependencies = []; |
| options.client = opts.client || false; |
| options.escapeFunction = opts.escape || utils.escapeXML; |
| options.compileDebug = opts.compileDebug !== false; |
| options.debug = !!opts.debug; |
| options.filename = opts.filename; |
| 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.outputFunctionName = opts.outputFunctionName; |
| options.localsName = opts.localsName || exports.localsName || _DEFAULT_LOCALS_NAME; |
| options.views = opts.views; |
| options.async = opts.async; |
| |
| 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); |
| str = str.replace(/%/g, delim); |
| return new RegExp(str); |
| }, |
| |
| compile: function () { |
| var src; |
| var fn; |
| var opts = this.opts; |
| var prepended = ''; |
| var appended = ''; |
| var escapeFn = opts.escapeFunction; |
| var asyncCtor; |
| |
| if (!this.source) { |
| this.generateSource(); |
| prepended += ' var __output = [], __append = __output.push.bind(__output);' + '\n'; |
| if (opts.outputFunctionName) { |
| prepended += ' var ' + opts.outputFunctionName + ' = __append;' + '\n'; |
| } |
| if (opts._with !== false) { |
| prepended += ' with (' + opts.localsName + ' || {}) {' + '\n'; |
| appended += ' }' + '\n'; |
| } |
| appended += ' return __output.join("");' + '\n'; |
| this.source = prepended + this.source + appended; |
| } |
| |
| if (opts.compileDebug) { |
| src = 'var __line = 1' + '\n' |
| + ' , __lines = ' + JSON.stringify(this.templateText) + '\n' |
| + ' , __filename = ' + (opts.filename ? |
| JSON.stringify(opts.filename) : 'undefined') + ';' + '\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); |
| } |
| |
| try { |
| if (opts.async) { |
| // Have to use generated function for this, since in envs without support, |
| // it breaks in parsing |
| try { |
| asyncCtor = (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 { |
| asyncCtor = Function; |
| } |
| fn = new asyncCtor(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 (!e.async) { |
| e.message += '\n'; |
| e.message += 'Or, if you meant to create an async function, pass async: true as an option.'; |
| } |
| } |
| throw e; |
| } |
| |
| if (opts.client) { |
| fn.dependencies = this.dependencies; |
| return fn; |
| } |
| |
| // 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 = function (data) { |
| var include = function (path, includeData) { |
| var d = utils.shallowCopy({}, data); |
| if (includeData) { |
| d = utils.shallowCopy(d, includeData); |
| } |
| return includeFile(path, opts)(d); |
| }; |
| return fn.apply(opts.context, [data || {}, escapeFn, include, rethrow]); |
| }; |
| returnedFn.dependencies = this.dependencies; |
| 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`. |
| this.templateText = |
| this.templateText.replace(/\r/g, '').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; |
| |
| if (matches && matches.length) { |
| matches.forEach(function (line, index) { |
| var opening; |
| var closing; |
| var include; |
| var includeOpts; |
| var includeObj; |
| var includeSrc; |
| // 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 '<' + delimiter as key |
| // Then this can simply check against the map |
| if ( line.indexOf('<' + d) === 0 // If it is a tag |
| && line.indexOf('<' + d + d) !== 0) { // and is not escaped |
| closing = matches[index + 2]; |
| if (!(closing == d + '>' || closing == '-' + d + '>' || closing == '_' + d + '>')) { |
| throw new Error('Could not find matching close tag for "' + line + '".'); |
| } |
| } |
| // HACK: backward-compat `include` preprocessor directives |
| if ((include = line.match(/^\s*include\s+(\S+)/))) { |
| opening = matches[index - 1]; |
| // Must be in EVAL or RAW mode |
| if (opening && (opening == '<' + d || opening == '<' + d + '-' || opening == '<' + d + '_')) { |
| includeOpts = utils.shallowCopy({}, self.opts); |
| includeObj = includeSource(include[1], includeOpts); |
| if (self.opts.compileDebug) { |
| includeSrc = |
| ' ; (function(){' + '\n' |
| + ' var __line = 1' + '\n' |
| + ' , __lines = ' + JSON.stringify(includeObj.template) + '\n' |
| + ' , __filename = ' + JSON.stringify(includeObj.filename) + ';' + '\n' |
| + ' try {' + '\n' |
| + includeObj.source |
| + ' } catch (e) {' + '\n' |
| + ' rethrow(e, __lines, __filename, __line, escapeFn);' + '\n' |
| + ' }' + '\n' |
| + ' ; }).call(this)' + '\n'; |
| }else{ |
| includeSrc = ' ; (function(){' + '\n' + includeObj.source + |
| ' ; }).call(this)' + '\n'; |
| } |
| self.source += includeSrc; |
| self.dependencies.push(exports.resolveInclude(include[1], |
| includeOpts.filename)); |
| return; |
| } |
| } |
| 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; |
| } |
| else if (this.opts.rmWhitespace) { |
| // rmWhitespace has already removed trailing spaces, just need |
| // to remove linebreaks |
| line = line.replace(/^\n/, ''); |
| } |
| 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 newLineCount = 0; |
| |
| newLineCount = (line.split('\n').length - 1); |
| |
| switch (line) { |
| case '<' + d: |
| case '<' + d + '_': |
| this.mode = Template.modes.EVAL; |
| break; |
| case '<' + d + '=': |
| this.mode = Template.modes.ESCAPED; |
| break; |
| case '<' + d + '-': |
| this.mode = Template.modes.RAW; |
| break; |
| case '<' + d + '#': |
| this.mode = Template.modes.COMMENT; |
| break; |
| case '<' + d + d: |
| this.mode = Template.modes.LITERAL; |
| this.source += ' ; __append("' + line.replace('<' + d + d, '<' + d) + '")' + '\n'; |
| break; |
| case d + d + '>': |
| this.mode = Template.modes.LITERAL; |
| this.source += ' ; __append("' + line.replace(d + d + '>', d + '>') + '")' + '\n'; |
| break; |
| case d + '>': |
| case '-' + d + '>': |
| case '_' + d + '>': |
| 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; |
| |
| // Add require support |
| /* istanbul ignore else */ |
| if (require.extensions) { |
| require.extensions['.ejs'] = function (module, flnm) { |
| var filename = flnm || /* istanbul ignore next */ module.filename; |
| var options = { |
| filename: filename, |
| client: true |
| }; |
| var template = fileLoader(filename).toString(); |
| var fn = exports.compile(template, options); |
| module._compile('module.exports = ' + fn.toString() + ';', filename); |
| }; |
| } |
| |
| /** |
| * 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; |
| } |