Version 3.133.123.113.10

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

Modules intégrés propres à Brython

Travailler avec Brython

Recettes

module browser.aio

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()

Requêtes Ajax

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

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

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

Objets Request

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

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)

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

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.

Futures

Exemples

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())

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())

from browser import timer, aio

async def main():
    fut = aio.Future()
    timer.set_timeout(lambda: fut.set_result("timeout!"), 2000)
    print("awaiting...")
    result = await fut
    print(f"future awaited, result: {result}")

aio.run(main())