Introduction

Installation

Limitations du protocole "file"

Questions fréquemment posées

Syntaxe, mots-clés et fonctions intégrées

Distribution standard

Implémentation de import

Packages Brython

Interface avec le navigateur

Introduction - API DOM
Créer un document
Accéder aux éléments
Attributs, propriétés et méthodes

Evénements
Evénements souris
Evénements clavier
Evénements focus
Evénements pour glisser-déposer

Chaine de requête

Objets et librairies Javascript

Modules intégrés propres à Brython

browser
browser.aio
browser.ajax
browser.html
browser.local_storage
browser.markdown
browser.object_storage
browser.session_storage
browser.svg
browser.template
browser.timer
browser.webcomponent
browser.websocket
browser.worker

Widgets
browser.widgets.dialog
browser.widgets.menu

interpreter
javascript

Travailler avec Brython

Options de la fonction brython()
Test et débogage
Deployer une application

Recettes

Salut !
Insérer du contenu dans un élément
Mise en forme HTML (gras, italique...)
Table HTML
Attacher / détacher des événements
Gérer la sélection d'options dans un SELECT
Glisser-déposer
Obtenir le contenu d'un élément
Lire le contenu d'un fichier
Stocker des objets localement
Exemple de onmouseover
 

module browser.aio

Ce module permet de gérer la programmation asynchrone en Brython en utilisant les mots-clés async et await.

Il remplace le module asyncio de la distribution standard CPython, qui ne peut pas fonctionner dans le contexte du navigateur:

  1. il utilise des fonctions bloquantes comme run() ou run_until_complete(), or le mode de fonctionnement des navigateurs ne permet pas de définir des fonctions dont l'exécution est suspendue dans l'attente d'un événement.

  2. le navigateur possède sa propre boucle d'événements, il n'est pas possible d'en définir une autre comme le fait asyncio avec la fonction set_event_loop()

Le module browser.aio définit les fonctions asynchrones suivantes:

Requêtes Ajax

ajax(method, url[, format="text", headers=None, data=None, cache=False])

req = await ajax("GET", url) suspend l'exécution d'une fonction asynchrone jusqu'à ce que la requête Ajax de type method ("GET", "POST", "PUT", etc.) vers l'URL spécifiée soit effectuée. La valeur de retour est une instance de la classe Request (voir ci-dessous).

format est le format de réponse attendu. Les valeurs possibles sont:

"text" : le contenu du fichier est renvoyé comme chaine de caractères

"binary" : une instance de la classe bytes

"dataURL" : une chaine de caractères au format dataURL

headers est un dictionnaire avec les entêtes HTTP à envoyer avec la requête.

data est une chaine de caractères, ou un dictionnaire qui sera converti en chaine de caractères pour former la chaine de requête ("query string") pour la méthode "GET" et en corps de la requête pour "POST".

cache est un booléen qui indique s'il faut utiliser le cache du navigateur

get(url[, format="text", headers=None, data=None, cache=False])

raccourci pour ajax("GET", url...)

post(url[, format="text", headers=None, data=None])

raccourci pour ajax("POST", url...)

Objets Request

Les instances de la classe Request, retournées par await ajax(), await get() ou await post(), possèdent les attributs suivants:

data : le contenu du fichier, au format défini par l'argument format

response_headers : un dictionnaire correspondant aux entêtes de réponse

status : statut de la réponse HTTP sous forme d'entier (200, 404...)

statusText : statut de la réponse HTTP sous forme de chaine de caractères ("200 Ok", "404 File not found"...)

Autres fonctions asynchrones

event(element, name)

evt = await aio.event(element, "click") suspend l'exécution d'une fonction asynchrone jusqu'à ce que l'utilisateur clique sur l'élément spécifié. La valeur de retour est une instance de la classe DOMEvent (cf. la section événements)

sleep(seconds)

Dans une fonction asynchrone, await sleep(n) rend le contrôle au programme principal, et reprend l'exécution de la fonction au bout de n secondes.

Exécuter une fonction asynchrone

run(coroutine)

Exécute une coroutine, c'est-à-dire le résultat de l'appel d'une fonction asynchrone. Cette fonction est non bloquante : elle n'attend pas que la fonction appelée soit terminée pour exécuter les instructions sur les lignes suivantes. Le moment où la ligne suivante est exécutée n'est pas (facilement) prévisible.

Exemples

Saisie de texte dans un élément INPUT

from browser import alert, document, html, aio

async def main():
    input = html.INPUT()
    document <= input
    while True:
        ev = await aio.event(input, "blur")
        try:
            v = int(ev.target.value)
            input.remove()
            alert(f"Value: {v}")
            break
        except ValueError:
            input.value = ""

aio.run(main())

Lecture de fichiers

from browser import document, html, aio

async def main():
    req = await aio.ajax("GET", "test.html")
    print(len(req.data))
    req = await aio.get("eraser.png", format="binary")
    print(len(req.data))
    req = await aio.get("eraser.png", format="dataURL")
    document <= html.IMG(src=req.data)

aio.run(main())