ym-fullscreen-detector

检测 Windows 当前前台窗口是否真正覆盖其所在显示器。

特性

• 使用 Win32 与 DWM 获取前台窗口的可见边界
• 排除 Windows 桌面和普通最大化窗口
• 支持无边框全屏窗口
• 检测失败时返回 false
• 使用 TypeScript 构建 npm 入口和类型声明
• 使用 Node-API，并提供 Windows x64 预编译文件

安装

npm install ym-fullscreen-detector

发布到 npm 前，可以在相邻项目中本地安装：

pnpm add ../ym-fullscreen-detector

使用

import { isForegroundWindowFullscreen } from 'ym-fullscreen-detector';

if (isForegroundWindowFullscreen()) {
  // 当前活动窗口处于全屏状态
}

CommonJS：

const {
  isForegroundWindowFullscreen,
} = require('ym-fullscreen-detector');

API

isForegroundWindowFullscreen(): boolean

当前前台窗口覆盖整个显示器且不是带标准边框的普通最大化窗口时返回 true。不支持的平台、桌面窗口或检测异常返回 false。

开发

需要 Node.js、Python、Visual Studio C++ Build Tools 和 Windows SDK。

pnpm install
pnpm build:ts
pnpm prebuild:native
pnpm test
pnpm pack:check

支持范围

• Windows x64
• Node.js 18 及以上
• Electron（通过 Node-API）

License

GPL-3.0-or-later