# @dark-yasiya/yt-dl\.js 中文文档

规范地址：https://npmcn.com/package/%40dark-yasiya/yt-dl.js/

版本：1\.0\.5
npm 元数据更新时间：2024-12-31T04:21:10.574Z
中文译文更新时间：2026-11-11T11:48:04.884Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dark-yasiya/yt-dl.js
原文对照：https://npmcn.com/package/%40dark-yasiya/yt-dl.js/?lang=original
项目主页：https://github.com/DarkYasiya1/ytdl#readme
源码仓库：https://github.com/DarkYasiya1/ytdl

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：43.8 kB，3 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- 运行依赖：3 个
- 首次发布：2024-11-26T12:36:32.823Z
- 最新版本发布：2024-12-31T04:21:10.355Z
- 近 30 天下载量：4988（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 0 个）

## 中文简介

-   [关于](https://npmcn.com/package/%40dark-yasiya/yt-dl.js/#description-about)
-   [使用量](https://npmcn.com/package/%40dark-yasiya/yt-dl.js/#description-usage)
-   [作者数](https://npmcn.com/package/%40dark-yasiya/yt-dl.js/#description-authors)

## 安装

```sh
npm install @dark-yasiya/yt-dl.js
```

也可以使用：`pnpm add @dark-yasiya/yt-dl.js`、`yarn add @dark-yasiya/yt-dl.js`、`bun add @dark-yasiya/yt-dl.js`

## README

## 目录

-   [关于](https://npmcn.com/package/%40dark-yasiya/yt-dl.js/#readme-about)
-   [使用量](https://npmcn.com/package/%40dark-yasiya/yt-dl.js/#readme-usage)
-   [作者数](https://npmcn.com/package/%40dark-yasiya/yt-dl.js/#readme-authors)

## 关于

一个简单的YouTube视频下载器,用于音频和视频格式.

### 安装

```sh
yarn add @dark-yasiya/yt-dl.js
```

或者说

```sh
npm i @dark-yasiya/yt-dl.js
```

## 使用量

```ts
const { ytsearch, ytmp3, ytmp4 } = require('@dark-yasiya/yt-dl.js')
```

## Yt 搜索

```ts
const text = "lelena";
const result = ytsearch(text);
console.log(result);
```

```ts
{
  result: true,
  creator: '@DarkYasiya',
  results: [
    {
      type: 'video',
      videoId: '0geqOYqwL0s',
      url: 'https://youtube.com/watch?v=0geqOYqwL0s',
      title: 'Lelena (ලෙලෙනා) - Nilan Hettiarachchi Official Music Video',
      description: 'Title | Lelena Artiste | Nilan Hettiarachchi Music Produced by Chamath Sangeeth Lyrics | Dulan ARX ( Dulanja Alwis) Directed by ...',
      image: 'https://i.ytimg.com/vi/0geqOYqwL0s/hq720.jpg',
      thumbnail: 'https://i.ytimg.com/vi/0geqOYqwL0s/hq720.jpg',
      seconds: 195,
      timestamp: '3:15',
      duration: [Object],
      ago: '3 years ago',
      views: 37740125,
      author: [Object]
    },
    {
      type: 'video',
      videoId: 'AFqtArWpv-w',
      url: 'https://youtube.com/watch?v=AFqtArWpv-w',
      title: 'Nilan Hettiarachchi - ලෙලෙනා | Lelena (Lyrics)',
      description: 'Title | Lelena Artiste | Nilan Hettiarachchi Music Produced by Chamath Sangeeth Lyrics | Dulan ARX ( Dulanja Alwis) Directed by ...',
      image: 'https://i.ytimg.com/vi/AFqtArWpv-w/hq720.jpg',
      thumbnail: 'https://i.ytimg.com/vi/AFqtArWpv-w/hq720.jpg',
      seconds: 194,
      timestamp: '3:14',
      duration: [Object],
      ago: '3 years ago',
      views: 529654,
      author: [Object]
    },
    {
      type: 'video',
      videoId: 'qcKQCymbXWE',
      url: 'https://youtube.com/watch?v=qcKQCymbXWE',
      title: 'ලෙලෙනා - Lelena | Nilan Hettiarachchi song | Chipmunks & Himabole version song with lyrics',
      description: 'lelena Himabole Studio Thanks for watching ❤ Like Comment Share.',
      image: 'https://i.ytimg.com/vi/qcKQCymbXWE/hq720.jpg',
      thumbnail: 'https://i.ytimg.com/vi/qcKQCymbXWE/hq720.jpg',
      seconds: 169,
      timestamp: '2:49',
      duration: [Object],
      ago: '3 years ago',
      views: 1760313,
      author: [Object]
    } ... more results
  ]
}
```

## 下载 Ytmp3

```ts
const yturl = "https://www.youtube.com/watch?v=vOv2i88NmA4";
const result = ytmp3(yturl);
console.log(result);
```

```ts
{
  status: true,
  creator: '@DarkYasiya',
  result: {
    type: 'video',
    videoId: 'vOv2i88NmA4',
    url: 'https://youtube.com/watch?v=vOv2i88NmA4',
    title: 'Age Sinahawa Thahanam | ඇගෙ සිනහව තහනම් | Vini Productions - විනී',
    description: 'Age Sinahawa Thahanam | ඇගෙ සිනහව තහනම් | Vini Productions - විනී ✓1XBET MELBET ගහලා ...',
    image: 'https://i.ytimg.com/vi/vOv2i88NmA4/hq720.jpg',
    thumbnail: 'https://i.ytimg.com/vi/vOv2i88NmA4/hq720.jpg',
    seconds: 1541,
    timestamp: '25:41',
    duration: {
      toString: [Function: toString],
      seconds: 1541,
      timestamp: '25:41'
    },
    ago: '2 days ago',
    views: 2003354,
    author: {
      name: 'Vini Productions - විනී',
      url: 'https://youtube.com/@viniproductionsofficial'
    }
  },
  download: {
    url: 'https://dl187.filemate11.shop/?file=M3R4SUNiN3JsOHJ6WWQ2a3NQS1Y5ZGlxVlZIOCtyZ0ZuOUJ4OUJrdEFLTk5zWXhrNCt5aEs4aEJMNnBFaHMrSFFadDJvM3VBSnBXdVlFcXI0TjEvWVRqRTBvWjRtMmlLcTkxbGZKazBkRUM5dWJmbXMyRXpxMUN3Sm95SU1PZ1RUeUErK3hBb2xnUERpZE9DL0RUYzlsajk0bS9VS1h4ZTl4NWJlTmVHdEwwWmtFeWJLdFd5bHJKZDVtMnA2NVJBa2NDUHV3WGp3S1kzdDlKbUZROHhWc0FZKzgyd2g2Q0pnQmRjb3M5WitCenFwUEwxUUpnOEVLQ2hhVFprTm45TXU4bjJVdzRLMmljYnZUNlkrNzkycXpJdktlVW56blNiNzZEZ1BtZTJjK09pQVp5VWVhNjZvOHFrenRJbnVsblJyL0hDaUpOTmsxWDJINXV0RUlsWjV4OTI1N0dHNC9NMXlsTzYwVkpMeFBNQTNrNmhKUmhrSGNFWWNpRkpOTnBLQXl4Tg%3D%3D',
    size: '23.52 MB'
  }
}
```

## 下载 Ytmp4

```ts
const yturl = "https://www.youtube.com/watch?v=vOv2i88NmA4";
const quality = "360p";
const result = ytmp4(yturl, quality);
console.log(result);
```

```ts
{
  status: true,
  creator: '@DarkYasiya',
  result: {
    type: 'video',
    videoId: 'vOv2i88NmA4',
    url: 'https://youtube.com/watch?v=vOv2i88NmA4',
    title: 'Age Sinahawa Thahanam | ඇගෙ සිනහව තහනම් | Vini Productions - විනී',
    description: 'Age Sinahawa Thahanam | ඇගෙ සිනහව තහනම් | Vini Productions - විනී ✓1XBET MELBET ගහලා ...',
    image: 'https://i.ytimg.com/vi/vOv2i88NmA4/hq720.jpg',
    thumbnail: 'https://i.ytimg.com/vi/vOv2i88NmA4/hq720.jpg',
    seconds: 1541,
    timestamp: '25:41',
    duration: {
      toString: [Function: toString],
      seconds: 1541,
      timestamp: '25:41'
    },
    ago: '2 days ago',
    views: 2005666,
    author: {
      name: 'Vini Productions - විනී',
      url: 'https://youtube.com/@viniproductionsofficial'
    }
  },
  download: {
    url: 'https://carl89.oceansaver.in/pacific/?Fp8tZWSaFLBxdoyy08bKkra',
  }
}
```

## 作者数

-   [@ 黑暗时代](https://github.com/DarkYasiyaofc) - 被刮伤的作者

## 常见问题

### @dark-yasiya/yt-dl\.js 是什么？

关于 使用量 作者数

### 如何安装 @dark-yasiya/yt-dl\.js？

在项目目录运行 npm install @dark-yasiya/yt-dl\.js，或使用 pnpm add / yarn add / bun add。

### @dark-yasiya/yt-dl\.js 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/dark-yasiya\_\_yt-dl\.js 是否存在。

### @dark-yasiya/yt-dl\.js 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @dark-yasiya/yt-dl\.js 可以商用吗？

@dark-yasiya/yt-dl\.js 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @dark-yasiya/yt-dl\.js 的下载量有多少？

根据 npm 官方下载统计，@dark-yasiya/yt-dl\.js 在 2026/10/12 – 2026/11/10 这 30 天内被下载 4,988 次，日均约 166 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @dark-yasiya/yt-dl\.js 还在维护吗？

最新版本 1\.0\.5 发布于 2024/12/31（1\.9 年前）；至今共发布 6 个版本，其中过去 12 个月发布了 0 个；首次发布于 2024/11/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。