139 lines
7.2 KiB
TypeScript
139 lines
7.2 KiB
TypeScript
// 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)
|
||
})
|