Doesn't work with absolute paths

Assuming there is a file named ‘index.html’ in the directory, accessing the server at localhost:3000 returns a 404 Not Found with the code below. Note that the file does exist and the path is correct, as demonstrated by the fs.statSync call.

const app = require('koa')();
const send = require('koa-send');
const fs = require('fs');

const INDEX_FILE = `${__dirname}/index.html`;
// This string is an absolute path, e.g. in my case "/home/miguel/Programming/koa-send-test/index.html"

app.use(function*() {
    console.log(fs.statSync(INDEX_FILE)); //Returns a valid object
    yield send(this, INDEX_FILE); //Does nothing
});

app.listen(3000);

However if INDEX_FILE is set to a relative path, the code works fine and returns index.html when accessing localhost:3000

const INDEX_FILE = `index.html`;

[GreenGremlin]

It is that way to make sure developers don’t inadvertently give access to the root file system. You can do what you’re asking by setting the root option.

app.use(function*() {
    yield send(this, 'index.html', { root:'/var/www' });
});

[multimeric]

Ohhh I see. My first example was using an absolute path when it expects a path relative to the root, so we had to set root to ‘/’ for it to make sense.

Okay this behaviour makes a lot of sense. I think it’s just the documentation that’s confusing. I might get around to a PR if I get the time.