Files
Netcatty/components/terminal/hooks/useTerminalFilePaste.ts
T
陈奇 61e8de4270 fix: synchronous preventDefault in paste handler + text paste fallback
- event.preventDefault() must be called synchronously before the
  async IPC call, otherwise the browser processes the default paste
  action before we can intercept it
- When clipboard has no files (or on error), fall back to text paste
  via pasteTextIntoTerminal since the default action was already
  prevented
2026-06-09 12:13:59 +00:00

99 lines
3.1 KiB
TypeScript

import type { Terminal as XTerm } from "@xterm/xterm";
import type React from "react";
import { useEffect } from "react";
import { netcattyBridge } from "../../../infrastructure/services/netcattyBridge";
import { logger } from "../../../lib/logger";
import type { TerminalSession } from "../../../types";
import { extractRootPathsFromClipboardFiles } from "../terminalHelpers";
import { pasteTextIntoTerminal } from "../runtime/terminalUserPaste";
interface UseTerminalFilePasteOptions {
isLocalConnection: boolean;
status: TerminalSession["status"];
termRef: React.MutableRefObject<XTerm | null>;
sessionRef: React.MutableRefObject<string | null>;
terminalBackend: {
writeToSession: (sessionId: string, data: string, options?: { automated?: boolean }) => void;
};
scrollToBottomAfterProgrammaticInput: (data: string) => void;
containerRef: React.RefObject<HTMLDivElement | null>;
}
export function useTerminalFilePaste({
isLocalConnection,
status,
termRef,
sessionRef,
terminalBackend,
scrollToBottomAfterProgrammaticInput,
containerRef,
}: UseTerminalFilePasteOptions) {
useEffect(() => {
const container = containerRef.current;
if (!container) return;
const fallbackToTextPaste = () => {
const term = termRef.current;
if (!term || !sessionRef.current) return;
navigator.clipboard.readText().then((text) => {
if (text) {
pasteTextIntoTerminal(term, text, { scrollOnPaste: false });
}
}).catch(() => {
// clipboard access denied — silently ignore
});
};
const handlePaste = (event: ClipboardEvent) => {
if (!isLocalConnection || status !== "connected") return;
const bridge = netcattyBridge.get();
if (!bridge?.readClipboardFiles) return;
// ⚡ Must call preventDefault SYNCHRONOUSLY — the event lifecycle
// is synchronous; calling it after an await is too late and the
// browser will have already performed the default paste action.
event.preventDefault();
event.stopPropagation();
void (async () => {
try {
const files = await bridge.readClipboardFiles!();
if (files.length === 0) {
fallbackToTextPaste();
return;
}
const paths = extractRootPathsFromClipboardFiles(files);
if (paths.length === 0 || !sessionRef.current) {
fallbackToTextPaste();
return;
}
const pathsText = paths.join(" ");
terminalBackend.writeToSession(sessionRef.current, pathsText);
scrollToBottomAfterProgrammaticInput(pathsText);
termRef.current?.focus();
} catch (error) {
logger.error("Failed to handle file paste", error);
fallbackToTextPaste();
}
})();
};
container.addEventListener("paste", handlePaste, true);
return () => {
container.removeEventListener("paste", handlePaste, true);
};
}, [
containerRef,
isLocalConnection,
scrollToBottomAfterProgrammaticInput,
sessionRef,
status,
terminalBackend,
termRef,
]);
}