# Object wx.getWindowInfo()

> 基础库 2.20.1 开始支持，低版本需做[兼容处理](1003706)。

> __小程序插件__：支持，需要小程序基础库版本不低于 [2.21.3](1003706)
> 
> __微信 Windows 版__：支持
> 
> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

## 功能描述

获取窗口信息

## 返回值

### Object


```json
[
  {
    "属性": "pixelRatio",
    "类型": "number",
    "说明": "设备像素比"
  },
  {
    "属性": "screenWidth",
    "类型": "number",
    "说明": "屏幕宽度，单位px"
  },
  {
    "属性": "screenHeight",
    "类型": "number",
    "说明": "屏幕高度，单位px"
  },
  {
    "属性": "windowWidth",
    "类型": "number",
    "说明": "可使用窗口宽度，单位px"
  },
  {
    "属性": "windowHeight",
    "类型": "number",
    "说明": "可使用窗口高度，单位px"
  },
  {
    "属性": "statusBarHeight",
    "类型": "number",
    "说明": "状态栏的高度，单位px"
  },
  {
    "属性": "safeArea",
    "类型": "Object",
    "说明": "在竖屏正方向下的安全区域。部分机型没有安全区域概念，也不会返回 safeArea 字段，开发者需自行兼容。",
    "子项": [
      {
        "结构属性": "left",
        "类型": "number",
        "说明": "安全区域左上角横坐标"
      },
      {
        "结构属性": "right",
        "类型": "number",
        "说明": "安全区域右下角横坐标"
      },
      {
        "结构属性": "top",
        "类型": "number",
        "说明": "安全区域左上角纵坐标"
      },
      {
        "结构属性": "bottom",
        "类型": "number",
        "说明": "安全区域右下角纵坐标"
      },
      {
        "结构属性": "width",
        "类型": "number",
        "说明": "安全区域的宽度，单位逻辑像素"
      },
      {
        "结构属性": "height",
        "类型": "number",
        "说明": "安全区域的高度，单位逻辑像素"
      }
    ]
  },
  {
    "属性": "screenTop",
    "类型": "number",
    "说明": "窗口上边缘的y值"
  }
]
```

## 示例代码

```js
const windowInfo = wx.getWindowInfo()

console.log(windowInfo.pixelRatio)
console.log(windowInfo.screenWidth)
console.log(windowInfo.screenHeight)
console.log(windowInfo.windowWidth)
console.log(windowInfo.windowHeight)
console.log(windowInfo.statusBarHeight)
console.log(windowInfo.safeArea)
console.log(windowInfo.screenTop)
```