# checkPermissions

`function` in `seedcord` · v0.14.0

<https://docs.seedcord.org/packages/seedcord/0.14.0/functions/check-permissions>

Checks permissions for a Role or a GuildMember in a Guild. Refuses when a permission in `scope` is missing, or with `inverse` when one is present.

## Signature 1

```ts
checkPermissions(
    target: Role | GuildMember,
    ctx: Guild,
    scope: BotPermissionScope,
    inverse?: boolean,
    errors?: PermissionErrorCtors
): void
```

Checks permissions for a Role or a GuildMember in a Guild. Refuses when a permission in `scope` is missing, or with `inverse` when one is present.

Parameters.

- `target` `Role | GuildMember` — Role or member to check
- `ctx` `Guild` — Guild context
- `scope` `BotPermissionScope` — Permission bits to validate
- `inverse?` `boolean` — Whether to ensure absence of the given permissions
- `errors?` `PermissionErrorCtors` — Optional custom error constructors

Returns `void`.

## Signature 2

```ts
checkPermissions(
    target: Role | GuildMember,
    ctx: TextChannel,
    scope: BotPermissionScope,
    inverse?: boolean,
    errors?: PermissionErrorCtors
): void
```

Checks permissions for a Role or a GuildMember in a TextChannel. Refuses when a permission in `scope` is missing, or with `inverse` when one is present.

Parameters.

- `target` `Role | GuildMember` — Role or member to check
- `ctx` `TextChannel` — Channel context
- `scope` `BotPermissionScope` — Permission bits to validate
- `inverse?` `boolean` — Whether to ensure absence of the given permissions
- `errors?` `PermissionErrorCtors` — Optional custom error constructors

Returns `void`.

## Signature 3

```ts
checkPermissions(options: CheckPermissionOptions): void
```

Checks permissions using an options object. Refuses when a permission in [`scope`](/packages/seedcord/0.14.0/interfaces/check-permission-options#scope) is missing, or with `options.inverse` when one is present.

Parameters.

- `options` `CheckPermissionOptions` — Complete options for the check

Returns `void`.