# getFavicon

显示网站图标的图标。

收藏夹图标（收藏夹图标）是随网站附带的一个小图标，显示在浏览器地址栏、页面选项卡和书签菜单等位置。

![网站图标示例](https://1964008511-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPYERqqbndxGykbCZ2IQg%2Fuploads%2Fgit-blob-8383499b76a723de43e610079031cd2543c52a66%2Futils-favicon.png?alt=media)

## 签名

```ts
function getFavicon(
  url: string | URL,
  options?: {
    fallback?: Image.Fallback;
    size?: boolean;
    mask?: Image.Mask;
  }
): Image.ImageLike;
```

* `name` 是主题名称的字符串。
* `options.fallback`是一个 [Image.Fallback](https://raycast-doc.gitbook.io/zh/api-can-kao/user-interface/icons-and-images#image.fallback) 图标，以防找不到 Favicon。默认情况下，后备将为 `Icon.Link`。
* `options.size`是返回的图标的大小。默认情况下，它是 64 像素。
* `options.mask` 是应用于图标的 [Image.Mask](https://raycast-doc.gitbook.io/zh/api-can-kao/user-interface/icons-and-images#image.mask) 的大小。

返回一个可以在 Raycast 需要的地方使用的 [Image.ImageLike](https://raycast-doc.gitbook.io/zh/api-can-kao/user-interface/icons-and-images#image.imagelike)。

## 例子

```tsx
import { List } from "@raycast/api";
import { getFavicon } from "@raycast/utils";

export default function Command() {
  return (
    <List>
      <List.Item icon={getFavicon("https://raycast.com")} title="Raycast Website" />
    </List>
  );
}
```
