个人主页上的终端,最容易写成一句话:
eval(input.value)
省事,但代价很直接:任何访问者都能在你的页面上执行任意代码;CSP 里也没法开 unsafe-eval;出错时你甚至不知道是哪一步炸的。
这个站的终端换了一种做法:输入只用来查表。
命令不是字符串,是数据
所有命令集中在一个数组里:
{
name: 'spark',
aliases: ['./spark.sh', 'sh spark.sh'],
hint: '点一颗火花',
action: 'spark'
}
action 是一个固定的联合类型:
type CommandAction =
| 'help' | 'whoami' | 'list' | 'projects'
| 'motto' | 'spark' | 'contact' | 'clear';
用户按下 Enter 后,流程只有三步:
trim()并转小写;- 用
name和aliases查表; - 命中就执行对应的函数,没命中就输出
command not found。
没有 new Function,没有 eval,也没有把输入拼进 HTML。
输出一律走 textContent
终端里所有动态内容都用 document.createElement 建节点,再写 textContent。
const line = document.createElement('div');
line.className = 'line';
line.textContent = text;
output.append(line);
这样即使有人输入 <img src=x onerror=...>,它也只会被当成一行普通文字打印出来。
打字机不能打断读屏
逐字输出看起来很像终端,但对屏幕阅读器是灾难:每个字符都可能触发一次朗读。
处理方式是给输出区加 aria-live="polite",同时在打字期间设置 aria-busy="true",整段结束后再置回 false。长行和 prefers-reduced-motion 下直接整行出现,不做逐字。
历史记录、Esc 清屏、快捷按钮都只是同一个 run() 的入口,不复制逻辑。
移动端不抢焦点
手机上的输入框默认折叠,只留输出和五个快捷按钮。
点击”展开输入”才显示 input,并且不自动聚焦——否则键盘会顶起半个屏幕,把刚看的内容盖住。
成本
终端相关 JS 约 6.6KB,gzip 后 2.8KB。没有依赖,没有 polyfill。
终端的乐趣在交互,不在执行任意代码。把输入当数据看,安全性是顺带的,可维护性才是主要收益。