[**RongIMLib**](../README.md)

***

[RongIMLib](../globals.md) / deleteMessages

# Function: deleteMessages()

> **deleteMessages**(`conversation`, `messages`): `Promise`\<[`RCResult`](../interfaces/RCResult.md)\<`void`\>\>

按消息 UId 删除远端消息

## Parameters

### conversation

[`IConversationIdentifier`](../interfaces/IConversationIdentifier.md)

会话信息

### messages

`object`[]

消息列表

## Returns

`Promise`\<[`RCResult`](../interfaces/RCResult.md)\<`void`\>\>

## Description

根据消息的 ID、时间戳和方向（发送或接收）从服务端删除指定单个会话中的一条或一组消息。
**注意**：
1. 删除消息仅会删除本端消息，不会删除对端消息。A 与 B 之间的消息，A 删除消息后，B 仍然可以看到消息。如 B 需要无法查看需要调用撤回消息 [recallMessage](../variables/recallMessage.md)接口。
2. 仅适用于 App Key 已开通单群聊消息云端存储 的 App。
3. 服务端默认不会删除对应的离线消息补偿，如需彻底删除消息补偿，请提交工单，申请开通删除服务端历史消息时同时删除多端补偿的离线消息。

## Example

按消息 UId 删除消息示例：
```ts
const conversation = {
 conversationType: RongIMLib.ConversationType.PRIVATE,
 targetId: 'targetId',
};
const messages = [{
 messageUId: 'BS4O-P5AO-D1O6-9GPP', // 消息 UId
 sentTime: 1632728573423, // 消息发送时间
 messageDirection: RongIMLib.MessageDirection.SEND, // 消息方向
}];
const deleteRes = await RongIMLib.deleteMessages(conversation, messages);
console.info('删除消息结果：', deleteRes);
```