(
event: KeyEventLike,
target: KeyTargetLike | null | undefined,
shortcuts: readonly string[],
)
| 108 | |
| 109 | /** Was von diesem Tastendruck ankam. */ |
| 110 | export function readKeyEvent( |
| 111 | event: KeyEventLike, |
| 112 | target: KeyTargetLike | null | undefined, |
| 113 | shortcuts: readonly string[], |
| 114 | ): KeyProbeReading { |
| 115 | const defaultPrevented = event.defaultPrevented === true; |
| 116 | /* |
| 117 | * Die Felder werden einzeln abgeschrieben und das Ereignis NICHT kopiert. |
| 118 | * |
| 119 | * `{ ...event }` liefert bei einem echten KeyboardEvent ein leeres Objekt: |
| 120 | * `code`, `key` und die Modifikatoren liegen auf dem Prototyp und nicht am |
| 121 | * Objekt selbst. Ein Test, der so kopiert, meldet zu jedem Tastendruck |
| 122 | * "kein Kuerzel", also genau den Befund, den er aufklaeren soll. |
| 123 | */ |
| 124 | const arrived: KeyEventLike = { |
| 125 | key: event.key ?? '', |
| 126 | code: event.code ?? '', |
| 127 | altKey: event.altKey === true, |
| 128 | ctrlKey: event.ctrlKey === true, |
| 129 | metaKey: event.metaKey === true, |
| 130 | shiftKey: event.shiftKey === true, |
| 131 | // Ausdruecklich false: die Frage lautet "war das ein Kuerzel", nicht |
| 132 | // "war es noch zu haben". |
| 133 | defaultPrevented: false, |
| 134 | }; |
| 135 | const handled = handledShortcutOf(event as unknown as object); |
| 136 | // Der Griff am Fenster bestellt ein erkanntes Kuerzel selbst ab. Ohne die |
| 137 | // Marke sagte `defaultPrevented` also bei jedem funktionierenden Kuerzel |
| 138 | // "jemand hat es verbraucht", und der Test waere in genau dem Fall |
| 139 | // irrefuehrend, fuer den er gebaut ist. |
| 140 | const consumedBy: KeyProbeConsumer = |
| 141 | handled !== undefined ? 'this-window' : defaultPrevented ? 'something-else' : 'nobody'; |
| 142 | return { |
| 143 | code: arrived.code ?? '', |
| 144 | key: arrived.key, |
| 145 | altKey: arrived.altKey === true, |
| 146 | ctrlKey: arrived.ctrlKey === true, |
| 147 | metaKey: arrived.metaKey === true, |
| 148 | shiftKey: arrived.shiftKey === true, |
| 149 | defaultPrevented, |
| 150 | consumedBy, |
| 151 | shortcut: menuShortcutFor(arrived, target, shortcuts) ?? '', |
| 152 | targetTag: (target?.tagName ?? '').toUpperCase(), |
| 153 | typingTarget: isTypingTarget(target), |
| 154 | }; |
| 155 | } |
no test coverage detected