dsh-better-chat/tests/chat/approval-keys.test.ts

139 lines
7.2 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// dsh-better-chat 审批快捷键:纯判定与按钮定位的单元测试(假 DOM,零依赖)。
import { test } from 'vitest'
import assert from 'node:assert/strict'
import {
actionButtons,
findPendingCard,
decideKeyAction,
shouldAutoFocus,
} from '../../src/client/chat/approval-keys.ts'
// --- 极小假 DOM:只实现模块用到的表面 ---
function matches(el: any, selector: string): boolean {
return selector.split(',').some((part) => {
const s = part.trim()
if (s.startsWith('[')) {
const m = s.match(/^\[([a-zA-Z-]+)(?:="([^"]*)")?\]$/)
if (!m) return false
const v = el.attrs[m[1]]
return m[2] === undefined ? v !== undefined : v === m[2]
}
return el.tag === s
})
}
class El {
tag: string
attrs: Record<string, string>
children: El[] = []
parent: El | null = null
disabled = false
clicks = 0
focused = 0
ownerDocument: any = null
constructor(tag: string, attrs: Record<string, string> = {}, children: El[] = []) {
this.tag = tag
this.attrs = attrs
for (const c of children) this.append(c)
}
append(c: El) { c.parent = this; this.children.push(c); return c }
getAttribute(n: string) { return this.attrs[n] ?? null }
closest(sel: string) { let e: El | null = this; while (e) { if (matches(e, sel)) return e; e = e.parent } return null }
contains(other: any) { let e = other; while (e) { if (e === this) return true; e = e.parent } return false }
querySelectorAll(sel: string) { const out: El[] = []; const walk = (e: El) => { for (const c of e.children) { if (matches(c, sel)) out.push(c); walk(c) } }; walk(this); return out }
querySelector(sel: string) { return this.querySelectorAll(sel)[0] ?? null }
click() { this.clicks++ }
focus() { this.focused++ }
}
function approvalCard({ busy = false, withAlways = false, detailButton = false } = {}): El {
const scrollChildren = detailButton ? [new El('button')] : []
return new El('div', { 'data-approval-key': 'k1', ...(busy ? { 'aria-busy': 'true' } : {}) }, [
new El('div', { 'data-approval-scroll': '' }, scrollChildren),
new El('div', {}, [
new El('button'), // 拒绝
new El('button'), // 允许(单次)
...(withAlways ? [new El('button')] : []), // 始终允许
]),
])
}
const baseInput = {
key: 'Enter', ctrlKey: false, metaKey: false, altKey: false, shiftKey: false,
repeat: false, isComposing: false, keyCode: 13, defaultPrevented: false,
target: new El('div'), activeElement: new El('body'), card: approvalCard(),
} as any
test('回车 → allow,Esc → reject(焦点不在卡内、非输入状态)', () => {
assert.equal(decideKeyAction(baseInput), 'allow')
assert.equal(decideKeyAction({ ...baseInput, key: 'Escape', keyCode: 27 }), 'reject')
})
test('没有待审批卡 → 不管', () => {
assert.equal(decideKeyAction({ ...baseInput, card: null }), null)
})
test('焦点已在卡内 → 交给官方处理(Ctrl/Cmd+Enter 例外)', () => {
const card = approvalCard()
const inside = card.querySelector('[data-approval-scroll]')
assert.equal(decideKeyAction({ ...baseInput, card, activeElement: inside }), null)
assert.equal(decideKeyAction({ ...baseInput, card, activeElement: inside, ctrlKey: true, hasAlways: true }), 'always')
assert.equal(decideKeyAction({ ...baseInput, card, activeElement: inside, metaKey: true, hasAlways: true }), 'always')
})
test('正在输入控件里打字 → 不管(textarea / input / contenteditable)', () => {
for (const target of [new El('textarea'), new El('input'), new El('div', { contenteditable: 'true' })]) {
assert.equal(decideKeyAction({ ...baseInput, target }), null)
assert.equal(decideKeyAction({ ...baseInput, target, key: 'Escape', keyCode: 27 }), null)
}
})
test('修饰键、连发、输入法组词、已被处理 → 不管(Ctrl/Cmd+Enter 始终允许是唯一例外)', () => {
assert.equal(decideKeyAction({ ...baseInput, ctrlKey: true }), null)
assert.equal(decideKeyAction({ ...baseInput, metaKey: true }), null)
assert.equal(decideKeyAction({ ...baseInput, ctrlKey: true, hasAlways: true }), 'always')
assert.equal(decideKeyAction({ ...baseInput, metaKey: true, hasAlways: true }), 'always')
assert.equal(decideKeyAction({ ...baseInput, ctrlKey: true, shiftKey: true, hasAlways: true }), null)
assert.equal(decideKeyAction({ ...baseInput, ctrlKey: true, altKey: true, hasAlways: true }), null)
assert.equal(decideKeyAction({ ...baseInput, shiftKey: true }), null)
assert.equal(decideKeyAction({ ...baseInput, repeat: true }), null)
assert.equal(decideKeyAction({ ...baseInput, repeat: true, hasAlways: true }), null)
assert.equal(decideKeyAction({ ...baseInput, isComposing: true }), null)
assert.equal(decideKeyAction({ ...baseInput, keyCode: 229 }), null)
assert.equal(decideKeyAction({ ...baseInput, defaultPrevented: true }), null)
assert.equal(decideKeyAction({ ...baseInput, key: 'a', keyCode: 65 }), null)
assert.equal(decideKeyAction({ ...baseInput, key: 'Escape', ctrlKey: true, hasAlways: true }), null)
})
test('Ctrl/Cmd+Enter 只在卡片确实有可用的「始终允许」按钮时成立', () => {
const withAlways = approvalCard({ withAlways: true })
const withoutAlways = approvalCard()
assert.equal(decideKeyAction({ ...baseInput, card: withAlways, ctrlKey: true, hasAlways: true }), 'always')
assert.equal(decideKeyAction({ ...baseInput, card: withoutAlways, ctrlKey: true }), null)
// 正在输入控件里打字时,带修饰键的组合键也不拦截。
assert.equal(decideKeyAction({ ...baseInput, target: new El('textarea'), ctrlKey: true, hasAlways: true }), null)
})
test('回车落在别的按钮上 → 保留按钮原生行为;Esc 不受此限', () => {
const btn = new El('button')
assert.equal(decideKeyAction({ ...baseInput, target: btn }), null)
assert.equal(decideKeyAction({ ...baseInput, target: btn, key: 'Escape', keyCode: 27 }), 'reject')
})
test('actionButtons:跳过详情区内的按钮,顺序为 [拒绝, 允许, 始终允许?]', () => {
const card = approvalCard({ withAlways: true, detailButton: true })
const buttons = actionButtons(card as any)
assert.equal(buttons.length, 3)
assert.equal(buttons.includes(card.querySelector('[data-approval-scroll]')!.children[0] as any), false)
})
test('findPendingCard:跳过已作答与按钮被禁用的卡', () => {
const doc = new El('div', {}, [approvalCard({ busy: true }), approvalCard()])
const found = findPendingCard(doc as any)
assert.ok(found)
assert.equal(found!.getAttribute('aria-busy'), null)
const disabledCard = approvalCard()
actionButtons(disabledCard as any)[1].disabled = true
const doc2 = new El('div', {}, [disabledCard])
assert.equal(findPendingCard(doc2 as any), null)
})
test('shouldAutoFocus:主体焦点可送入,别处输入不抢,已在卡内不重复', () => {
const card = approvalCard()
const doc: any = { body: new El('body') }
card.ownerDocument = doc
assert.equal(shouldAutoFocus(null, card as any), true)
assert.equal(shouldAutoFocus(doc.body, card as any), true)
assert.equal(shouldAutoFocus(new El('textarea') as any, card as any), false)
assert.equal(shouldAutoFocus(card.querySelector('[data-approval-scroll]') as any, card as any), false)
assert.equal(shouldAutoFocus(new El('div') as any, card as any), true)
})