ACL - Documentation

ACL

Parse. ACL

Creates a new ACL. If no argument is given, the ACL has no permissions for anyone. If the argument is a Parse.User, the ACL will have read and write permission for only that user. If the argument is any other JSON object, that object will be interpretted as a serialized ACL created with toJSON().

An ACL, or Access Control List can be added to any Parse.Object to restrict access to only a subset of users of your application.

Constructor

new ACL(arg1)

Parameters:

Name	Type	Description
`arg1`	`Parse.User` \| `object`	The user to initialize the ACL for

Methods

equals(other) → {boolean}

Returns whether this ACL is equal to another object

Parameters:

Name	Type	Description
`other`	`ParseACL`	The other object's ACL to compare to

Returns:

Type:: boolean

getPublicReadAccess() → {boolean}

Gets whether the public is allowed to read this object.

Returns:

Type:: boolean

getPublicWriteAccess() → {boolean}

Gets whether the public is allowed to write this object.

Returns:

Type:: boolean

getReadAccess(userId) → {boolean}

Get whether the given user id is explicitly allowed to read this object. Even if this returns false, the user may still be able to access it if getPublicReadAccess returns true or a role that the user belongs to has write access.

Parameters:

Name	Type	Description
`userId`		An instance of Parse.User or its objectId, or a Parse.Role.

Returns:

Type:: boolean

getRoleReadAccess(role) → {boolean}

Gets whether users belonging to the given role are allowed to read this object. Even if this returns false, the role may still be able to write it if a parent role has read access.

Parameters:

Name	Type	Description
`role`		The name of the role, or a Parse.Role object.

Throws:

If role is neither a Parse.Role nor a String.
Type TypeError

Returns:

Type:: boolean

true if the role has read access. false otherwise.

getRoleWriteAccess(role) → {boolean}

Gets whether users belonging to the given role are allowed to write this object. Even if this returns false, the role may still be able to write it if a parent role has write access.

Parameters:

Name	Type	Description
`role`		The name of the role, or a Parse.Role object.

Throws:

If role is neither a Parse.Role nor a String.
Type TypeError

Returns:

Type:: boolean

true if the role has write access. false otherwise.

getWriteAccess(userId) → {boolean}

Gets whether the given user id is explicitly allowed to write this object. Even if this returns false, the user may still be able to write it if getPublicWriteAccess returns true or a role that the user belongs to has write access.

Parameters:

Name	Type	Description
`userId`		An instance of Parse.User or its objectId, or a Parse.Role.

Returns:

Type:: boolean

setPublicReadAccess(allowed)

Sets whether the public is allowed to read this object.

Parameters:

Name	Type	Description
`allowed`	`boolean`

setPublicWriteAccess(allowed)

Sets whether the public is allowed to write this object.

Parameters:

Name	Type	Description
`allowed`	`boolean`

setReadAccess(userId, allowed)

Sets whether the given user is allowed to read this object.

Parameters:

Name	Type	Description
`userId`		An instance of Parse.User or its objectId.
`allowed`	`boolean`	Whether that user should have read access.

setRoleReadAccess(role, allowed)

Sets whether users belonging to the given role are allowed to read this object.

Parameters:

Name	Type	Description
`role`		The name of the role, or a Parse.Role object.
`allowed`	`boolean`	Whether the given role can read this object.

Throws:

If role is neither a Parse.Role nor a String.
Type TypeError

setRoleWriteAccess(role, allowed)

Sets whether users belonging to the given role are allowed to write this object.

Parameters:

Name	Type	Description
`role`		The name of the role, or a Parse.Role object.
`allowed`	`boolean`	Whether the given role can write this object.

Throws:

If role is neither a Parse.Role nor a String.
Type TypeError

setWriteAccess(userId, allowed)

Sets whether the given user id is allowed to write this object.

Parameters:

Name	Type	Description
`userId`		An instance of Parse.User or its objectId, or a Parse.Role..
`allowed`	`boolean`	Whether that user should have write access.

toJSON() → {object}

Returns a JSON-encoded version of the ACL.

Returns:

Type:: object