/*! * Connect - directory * Copyright(c) 2011 Sencha Inc. * Copyright(c) 2011 TJ Holowaychuk * MIT Licensed */ // TODO: icon / style for directories // TODO: arrow key navigation // TODO: make icons extensible /** * Module dependencies. */ var fs = require('fs') , parse = require('url').parse , utils = require('../utils') , path = require('path') , normalize = path.normalize , extname = path.extname , join = path.join; /*! * Icon cache. */ var cache = {}; /** * Directory: * * Serve directory listings with the given `root` path. * * Options: * * - `hidden` display hidden (dot) files. Defaults to false. * - `icons` display icons. Defaults to false. * - `filter` Apply this filter function to files. Defaults to false. * * @param {String} root * @param {Object} options * @return {Function} * @api public */ exports = module.exports = function directory(root, options){ options = options || {}; // root required if (!root) throw new Error('directory() root path required'); var hidden = options.hidden , icons = options.icons , filter = options.filter , root = normalize(root); return function directory(req, res, next) { if ('GET' != req.method && 'HEAD' != req.method) return next(); var accept = req.headers.accept || 'text/plain' , url = parse(req.url) , dir = decodeURIComponent(url.pathname) , path = normalize(join(root, dir)) , originalUrl = parse(req.originalUrl) , originalDir = decodeURIComponent(originalUrl.pathname) , showUp = path != root && path != root + '/'; // null byte(s), bad request if (~path.indexOf('\0')) return next(utils.error(400)); // malicious path, forbidden if (0 != path.indexOf(root)) return next(utils.error(403)); // check if we have a directory fs.stat(path, function(err, stat){ if (err) return 'ENOENT' == err.code ? next() : next(err); if (!stat.isDirectory()) return next(); // fetch files fs.readdir(path, function(err, files){ if (err) return next(err); if (!hidden) files = removeHidden(files); if (filter) files = files.filter(filter); files.sort(); // content-negotiation for (var key in exports) { if (~accept.indexOf(key) || ~accept.indexOf('*/*')) { exports[key](req, res, files, next, originalDir, showUp, icons); return; } } // not acceptable next(utils.error(406)); }); }); }; }; /** * Respond with text/html. */ exports.html = function(req, res, files, next, dir, showUp, icons){ fs.readFile(__dirname + '/../public/directory.html', 'utf8', function(err, str){ if (err) return next(err); fs.readFile(__dirname + '/../public/style.css', 'utf8', function(err, style){ if (err) return next(err); if (showUp) files.unshift('..'); str = str .replace('{style}', style) .replace('{files}', html(files, dir, icons)) .replace('{directory}', dir) .replace('{linked-path}', htmlPath(dir)); res.setHeader('Content-Type', 'text/html'); res.setHeader('Content-Length', str.length); res.end(str); }); }); }; /** * Respond with application/json. */ exports.json = function(req, res, files){ files = JSON.stringify(files); res.setHeader('Content-Type', 'application/json'); res.setHeader('Content-Length', files.length); res.end(files); }; /** * Respond with text/plain. */ exports.plain = function(req, res, files){ files = files.join('\n') + '\n'; res.setHeader('Content-Type', 'text/plain'); res.setHeader('Content-Length', files.length); res.end(files); }; /** * Map html `dir`, returning a linked path. */ function htmlPath(dir) { var curr = []; return dir.split('/').map(function(part){ curr.push(part); return '' + part + ''; }).join(' / '); } /** * Map html `files`, returning an html unordered list. */ function html(files, dir, useIcons) { return '