{"id": "internals:datasette-check-visibility", "page": "internals", "ref": "datasette-check-visibility", "title": "await .check_visibility(actor, action=None, resource=None, permissions=None)", "content": "actor  - dictionary \n                         \n                             The authenticated actor. This is usually  request.actor . \n                         \n                     \n                     \n                         action  - string, optional \n                         \n                             The name of the action that is being permission checked. \n                         \n                     \n                     \n                         resource  - string or tuple, optional \n                         \n                             The resource, e.g. the name of the database, or a tuple of two strings containing the name of the database and the name of the table. Only some permissions apply to a resource. \n                         \n                     \n                     \n                         permissions  - list of  action  strings or  (action, resource)  tuples, optional \n                         \n                             Provide this instead of  action  and  resource  to check multiple permissions at once. \n                         \n                     \n                 \n                 This convenience method can be used to answer the question \"should this item be considered private, in that it is visible to me but it is not visible to anonymous users?\" \n                 It returns a tuple of two booleans,  (visible, private) .  visible  indicates if the actor can see this resource.  private  will be  True  if an anonymous user would not be able to view the resource. \n                 This example checks if the user can access a specific table, and sets  private  so that a padlock icon can later be displayed: \n                 visible, private = await datasette.check_visibility(\n    request.actor,\n    action=\"view-table\",\n    resource=(database, table),\n) \n                 The following example runs three checks in a row, similar to  await .ensure_permissions(actor, permissions) . If any of the checks are denied before one of them is explicitly granted then  visible  will be  False .  private  will be  True  if an anonymous user would not be able to view the resource. \n                 visible, private = await datasette.check_visibility(\n    request.actor,\n    permissions=[\n        (\"view-table\", (database, table)),\n        (\"view-database\", database),\n        \"view-instance\",\n    ],\n)", "breadcrumbs": "[\"Internals for plugins\", \"Datasette class\"]", "references": "[]"}