# ContactSelf

## ContactSelf

{% hint style="info" %}
这个类继承自 Contact
{% endhint %}

**Kind**: global class

* [ContactSelf](/wechaty/zh/api/contact-self.md#contactself)
  * [contactSelf.avatar() ⇒ Promise](https://wechaty.gitbook.io/wechaty/zh/api/pages/-Lv6eNQVcl9isoEPrXga#contactselfavatar-⇒-promisefilebox)
  * [contactSelf.avatar(file) ⇒ `Promise<void>`](https://wechaty.gitbook.io/wechaty/zh/api/pages/-Lv6eNQVcl9isoEPrXga#contactselfavatarfile-⇒-promisevoid)
  * [contactSelf.qrcode() ⇒ `Promise<string>`](https://wechaty.gitbook.io/wechaty/zh/api/pages/-Lv6eNQVcl9isoEPrXga#contactselfqrcode-⇒-promisestring)
  * [contactSelf.name() ⇒ `string`](https://wechaty.gitbook.io/wechaty/zh/api/pages/-Lv6eNQVcl9isoEPrXga#contactselfname-⇒-string)
  * [contactSelf.name(name) ⇒ `Promise<string>`](https://wechaty.gitbook.io/wechaty/zh/api/pages/-Lv6eNQVcl9isoEPrXga#contactselfnamename-⇒-promisestring)
  * [contactSelf.signature(signature): `Promise<void>`](/wechaty/zh/api/contact-self.md#contactselfsignaturesignature-promisevoid)

**Kind**: instance method of [`ContactSelf`](/wechaty/zh/api/contact-self.md)

### contactSelf.avatar() ⇒ Promise

获取机器人的头像

**Example** *( GET the avatar for bot, return {Promise\<FileBox>})*

```javascript
// Save avatar to local file like `1-name.jpg`

bot.on('login', (user: ContactSelf) => {
  console.log(`user ${user} login`)
  const file = await user.avatar()
  const name = file.name
  await file.toFile(name, true)
  console.log(`Save bot avatar: ${contact.name()} with avatar file: ${name}`)
})
```

### contactSelf.avatar(file) ⇒ `Promise<void>`

设置 机器人的头像

| Param | Type      |
| ----- | --------- |
| file  | `FileBox` |

**Example** *(SET the avatar for a bot)*

```javascript
import { FileBox }  from 'file-box'
bot.on('login', (user: ContactSelf) => {
  console.log(`user ${user} login`)
  const fileBox = FileBox.fromUrl('https://chatie.io/wechaty/images/bot-qr-code.png')
  await user.avatar(fileBox)
  console.log(`Change bot avatar successfully!`)
})
```

### contactSelf.qrcode() ⇒ `Promise<string>`

获取机器人的二维码。

**Kind**: instance method of [`ContactSelf`](/wechaty/zh/api/contact-self.md#contactself) **Example**

```javascript
import { generate } from 'qrcode-terminal'
bot.on('login', (user: ContactSelf) => {
  console.log(`user ${user} login`)
  const qrcode = await user.qrcode()
  console.log(`Following is the bot qrcode!`)
  generate(qrcode, { small: true })
})
```

### contactSelf.name() ⇒ `string`

获取 机器人昵称。

**Kind**: instance method of [`ContactSelf`](/wechaty/zh/api/contact-self.md#contactself)

**Example**

```javascript
bot.on('login', async user => {
  console.log(`user ${user} login`)
  console.log(`user name: ${user.name()}`)
})
```

### contactSelf.name(name) ⇒ `Promise<string>`

修改机器人昵称。

**Kind**: instance method of [`ContactSelf`](/wechaty/zh/api/contact-self.md#contactself)

| Param | Description |
| ----- | ----------- |
| name  | 机器人要修改的昵称内容 |

**Example**

```javascript
bot.on('login', async user => {
  console.log(`user ${user} login`)
  const oldName = user.name()
  try {
    await user.name(`${oldName}-${new Date().getTime()}`)
  } catch (e) {
    console.error('change name failed', e)
  }
})
```

### contactSelf.signature(signature): `Promise<void>`

修改机器人签名。

**Kind**: instance method of [`ContactSelf`](/wechaty/zh/api/contact-self.md#contactself)

| Param     | Description |
| --------- | ----------- |
| signature | 机器人要修改的签名内容 |

**Example**

```javascript
bot.on('login', async user => {
  console.log(`user ${user} login`)
  try {
    await user.signature(`Signature changed by wechaty on ${new Date()}`)
  } catch (e) {
    console.error('change signature failed', e)
  }
})
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wechaty.gitbook.io/wechaty/zh/api/contact-self.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.